RemoteCommand Class

From RemObjects Software

This is a Data Abstract Architecture entry
Feel free to add your notes to this topic below.

Overview (.NET)

Provides the ability to dynamically invoke a Command from the server's Schema.

By default, the standard DataAbstractService Class is configured to prevent execution of arbitrary commands from the client, as this poses a possible security risk, depending on what kind of commands are defined on your schema.

To enable execution of commands form the client, set the AllowExecuteCommand property of your DataAbstractService to true and ensure that all published Commands in your schema are safe for execution. Also, you need to have proper authentication methods in place to prevent anonymous users from making malicious calls.

Namespace

• RemObjects.DataAbstract

Declaration (C#)

[Designer("RemObjects.DataAbstract.Designtime.RemoteCommandDesigner, RemObjects.DataAbstract.DesignTime,
Version=4.0.0.414, Culture=neutral, PublicKeyToken=3df3cad1b7aa5098"), ToolboxBitmap(typeof(RemoteCommand), "Glyphs.RemoteCommand.bmp")]
public class RemoteCommand : BaseComponent;

Hierarchy

• RemObjects. Common.BaseComponent
  • RemObjects.DataAbstract.RemoteCommand

Properties

Property	Type	Description
ExecuteCall	RemoteCommandRequest	The DynamicRequest that will be used to invoke the Command on the server. By default, it will be mapped to the ExecuteCommand call as defined in the IDataAbstractService Interface implemented by standard Data Abstract 4.0 servers. When using a custom server interface, you can change its sub-properties to control how the data update call is made.
RemoteService	RemoteService	References the RemoteService component that defines the service to call for executing the command.

Methods

Method	Description
Execute	Executes the command on the server. When executing a command, first the BeforeExecuteCommand event handler will be called, then call will be sent to the server and finally the AfterExecuteCommand event will be called. Before calling this method, make sure the RemoteService property is attached.
RemoteCommand	Default constructor for RemoteCommand.

Events

Event	Description
AfterExecuteCommand	Occurs after the remote command has been executed. The parameters for this event contain information on whether the call has succeeded, an exception if applicable and the number of affected records.
BeforeExecuteCommand	Occurs before a command is executed.

See Also

• Lists
  • Namespace List (Data Abstract)
  • Class List (Data Abstract for .NET)
  • Interface List (Data Abstract for .NET)
  • Enum List (Data Abstract for .NET)
  • Data Types (Data Abstract)
  • File Types (Data Abstract)

Product: RemObjects Data Abstract
Current version: Data Abstract 'Vinci' (5.0)

Lists — Glossary — Features — How To — Drivers — Components — Tools — Samples — Articles — Architecture — Issues