RemoteDataAdapterRequest
Overview
The RemoteDataAdapterRequest class expands DynamicRequest for Data Abstract-specific calls done from within the RemoteDataAdapter.
It is a base class for:
- SchemaRequest - used by Data Abstract to request the schema for a Data Abstract service from the server.
- DataUpdateRequest- used by Data Abstract to update data on the server.
- DataRequestRequest - used by Data Abstract to request data from the server.
You will not usually deal with instances of this classes directly, but use the SchemaCall, DataUpdateCall and DataRequestCall properties of the RemoteDataAdapter instead.
Location
- Reference: RemObjects.DataAbstract.dll
- Namespace: RemObjects.DataAbstract
- Ancestry: Component | DynamicRequest | RemoteDataAdapterRequest
constructor (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class.
constructor
RemoteDataAdapterRequest()
Sub New()
constructor (IContainer) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and adds it to the providec components collection.
constructor(container: IContainer)
RemoteDataAdapterRequest(IContainer container)
Sub New(container As IContainer)
Parameters:
- container: Components collection
constructor (String, RemoteService) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService)
Sub New(methodName As String, remoteService As RemoteService)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
constructor (String, RemoteService, array of DynamicRequestParameter) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: array of DynamicRequestParameter)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, DynamicRequestParameter[] parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As DynamicRequestParameter())
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (String, RemoteService, DynamicRequestParameterCollection) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: DynamicRequestParameterCollection)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, DynamicRequestParameterCollection parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As DynamicRequestParameterCollection)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (String, RemoteService, IList<DynamicRequestParameter>) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: IList<DynamicRequestParameter>)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, IList<DynamicRequestParameter> parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As IList<DynamicRequestParameter>)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (BaseDataAdapter)
constructor(owner: BaseDataAdapter)
RemoteDataAdapterRequest(BaseDataAdapter owner)
Sub New(owner As BaseDataAdapter)
Parameters:
- owner:
BeginMakeRequest (declared in DynamicRequest)
Asynchronously starts request to the remote service.
method BeginMakeRequest(cb: AsyncCallback; state: Object): IAsyncResult
IAsyncResult BeginMakeRequest(AsyncCallback cb, Object state)
Function BeginMakeRequest(cb As AsyncCallback, state As Object) As IAsyncResult
Parameters:
- cb: Callback method that will be called once the asynchronous operation is completed
- state: Asynchronous operation state object
EndMakeRequest (declared in DynamicRequest)
Finishes the asynchronous request to the remote service.
method EndMakeRequest(ar: IAsyncResult)
void EndMakeRequest(IAsyncResult ar)
Sub EndMakeRequest(ar As IAsyncResult)
Parameters:
- ar: Object representing the status of an asynchronous operation
MakeRequest (declared in DynamicRequest)
Performs the actual request to the remote service.
method MakeRequest
void MakeRequest()
Sub MakeRequest()
MethodName (declared in DynamicRequest)
Gets or sets the the name of the remote service method to call.
Note: If the DynamicRequest property is assigned and the server is available at design time, you can select the method name from a list of available methods in the Property Browser's drop down box. When doing this, the DynamicRequest collection will automatically be populated as well.
property MethodName: String read write;
String MethodName { get; set; }
Property MethodName() As String
Owner
property Owner: BaseDataAdapter read write;
BaseDataAdapter Owner { get; set; }
Property Owner() As BaseDataAdapter
ParameterByName (declared in DynamicRequest)
Returns the DynamicRequestParameter with the given name.
This method can be used to populate all parameters with their values without relying on their ordering.
method ParameterByName(parameterName: String): DynamicRequestParameter
DynamicRequestParameter ParameterByName(String parameterName)
Function ParameterByName(parameterName As String) As DynamicRequestParameter
Parameters:
- parameterName: Parameter name
Parameters (declared in DynamicRequest)
Gets collection of the parameters that will be passed into and out of the method call.
For the method call call to succeed these parameters have to exactly match the parameters defined for the service method on the server side.
The DynamicRequest and DynamicRequest methods can be used to populate the parameters automatically. Once the parameters are defined they an be accessed using the DynamicRequest method.
Note: If the DynamicRequest property is assigned and the server is available at design time, you can select the method name from a list of available methods in the Property Browser's drop down box. When doing this, the DynamicRequest collection will automatically be populated as well.
property Parameters: DynamicRequestParameterCollection read;
DynamicRequestParameterCollection Parameters { get; }
ReadOnly Property Parameters() As DynamicRequestParameterCollection
ReadParameter protected (declared in DynamicRequest)
Reads parameter's value from the provided IMessage instance.
method ReadParameter(message: IMessage; parameter: DynamicRequestParameter)
void ReadParameter(IMessage message, DynamicRequestParameter parameter)
Sub ReadParameter(message As IMessage, parameter As DynamicRequestParameter)
Parameters:
- message: Message used to communicate with the server
- parameter: Method call parameter
RemoteService (declared in DynamicRequest)
Gets or sets the RemoteService class instance that defines the remote service to call.
property RemoteService: RemoteService read write;
RemoteService RemoteService { get; set; }
Property RemoteService() As RemoteService
ResultParameter (declared in DynamicRequest)
Gets the parameter containing result of the remote method call.
property ResultParameter: DynamicRequestParameter read;
DynamicRequestParameter ResultParameter { get; }
ReadOnly Property ResultParameter() As DynamicRequestParameter
UpdateParamsFromRodl (declared in DynamicRequest)
Retrieves the RODL from the server, locates the service and method and populates the DynamicRequest collection with the appropriate parameter definitions required for the remote method call. Any parameters or values defined prior to calling this method will be removed.
method UpdateParamsFromRodl
void UpdateParamsFromRodl()
Sub UpdateParamsFromRodl()
UpdateParamsFromRodlOperation (declared in DynamicRequest)
Populates the DynamicRequest collection with the appropriate parameter definitions required for the remote method call. Any parameters or values defined prior to calling this method will be removed.
Unlike the DynamicRequest method this method doesn't try to obtain the RODL from the server. Instead it takes the needed information from the provided RodlOperation instance.
method UpdateParamsFromRodlOperation(operation: RodlOperation)
void UpdateParamsFromRodlOperation(RodlOperation operation)
Sub UpdateParamsFromRodlOperation(operation As RodlOperation)
Parameters:
- operation: Server method definition
Validate protected (declared in DynamicRequest)
Validates property values of the current DynamicRequest instance. This method is called when the remote method call is sent to the server.
This method validates the RemoteService.RemoteService settings and ensures that the RemoteService.MethodName property is set.
method Validate
void Validate()
Sub Validate()
WriteParameter protected (declared in DynamicRequest)
Writes parameter name, type and value to the provided IMessage instance.
method WriteParameter(message: IMessage; parameter: DynamicRequestParameter)
void WriteParameter(IMessage message, DynamicRequestParameter parameter)
Sub WriteParameter(message As IMessage, parameter As DynamicRequestParameter)
Parameters:
- message: Message used to communicate with the server
- parameter: Remote method call parameter
MethodName (declared in DynamicRequest)
Gets or sets the the name of the remote service method to call.
Note: If the DynamicRequest property is assigned and the server is available at design time, you can select the method name from a list of available methods in the Property Browser's drop down box. When doing this, the DynamicRequest collection will automatically be populated as well.
property MethodName: String read write;
String MethodName { get; set; }
Property MethodName() As String
Owner
property Owner: BaseDataAdapter read write;
BaseDataAdapter Owner { get; set; }
Property Owner() As BaseDataAdapter
Parameters (declared in DynamicRequest)
Gets collection of the parameters that will be passed into and out of the method call.
For the method call call to succeed these parameters have to exactly match the parameters defined for the service method on the server side.
The DynamicRequest and DynamicRequest methods can be used to populate the parameters automatically. Once the parameters are defined they an be accessed using the DynamicRequest method.
Note: If the DynamicRequest property is assigned and the server is available at design time, you can select the method name from a list of available methods in the Property Browser's drop down box. When doing this, the DynamicRequest collection will automatically be populated as well.
property Parameters: DynamicRequestParameterCollection read;
DynamicRequestParameterCollection Parameters { get; }
ReadOnly Property Parameters() As DynamicRequestParameterCollection
RemoteService (declared in DynamicRequest)
Gets or sets the RemoteService class instance that defines the remote service to call.
property RemoteService: RemoteService read write;
RemoteService RemoteService { get; set; }
Property RemoteService() As RemoteService
ResultParameter (declared in DynamicRequest)
Gets the parameter containing result of the remote method call.
property ResultParameter: DynamicRequestParameter read;
DynamicRequestParameter ResultParameter { get; }
ReadOnly Property ResultParameter() As DynamicRequestParameter
constructor (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class.
constructor
RemoteDataAdapterRequest()
Sub New()
constructor (IContainer) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and adds it to the providec components collection.
constructor(container: IContainer)
RemoteDataAdapterRequest(IContainer container)
Sub New(container As IContainer)
Parameters:
- container: Components collection
constructor (String, RemoteService) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService)
Sub New(methodName As String, remoteService As RemoteService)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
constructor (String, RemoteService, array of DynamicRequestParameter) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: array of DynamicRequestParameter)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, DynamicRequestParameter[] parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As DynamicRequestParameter())
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (String, RemoteService, DynamicRequestParameterCollection) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: DynamicRequestParameterCollection)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, DynamicRequestParameterCollection parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As DynamicRequestParameterCollection)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (String, RemoteService, IList<DynamicRequestParameter>) (declared in DynamicRequest)
Creates a new instance of the DynamicRequest class and sets its DynamicRequest, DynamicRequest and DynamicRequest properties.
constructor(methodName: String; remoteService: RemoteService; parameters: IList<DynamicRequestParameter>)
RemoteDataAdapterRequest(String methodName, RemoteService remoteService, IList<DynamicRequestParameter> parameters)
Sub New(methodName As String, remoteService As RemoteService, parameters As IList<DynamicRequestParameter>)
Parameters:
- methodName: Remote method name
- remoteService: RemoteService class instance identifying the remote service
- parameters: Parameters of the remote method call
constructor (BaseDataAdapter)
constructor(owner: BaseDataAdapter)
RemoteDataAdapterRequest(BaseDataAdapter owner)
Sub New(owner As BaseDataAdapter)
Parameters:
- owner:
BeginMakeRequest (declared in DynamicRequest)
Asynchronously starts request to the remote service.
method BeginMakeRequest(cb: AsyncCallback; state: Object): IAsyncResult
IAsyncResult BeginMakeRequest(AsyncCallback cb, Object state)
Function BeginMakeRequest(cb As AsyncCallback, state As Object) As IAsyncResult
Parameters:
- cb: Callback method that will be called once the asynchronous operation is completed
- state: Asynchronous operation state object
EndMakeRequest (declared in DynamicRequest)
Finishes the asynchronous request to the remote service.
method EndMakeRequest(ar: IAsyncResult)
void EndMakeRequest(IAsyncResult ar)
Sub EndMakeRequest(ar As IAsyncResult)
Parameters:
- ar: Object representing the status of an asynchronous operation
MakeRequest (declared in DynamicRequest)
Performs the actual request to the remote service.
method MakeRequest
void MakeRequest()
Sub MakeRequest()
ParameterByName (declared in DynamicRequest)
Returns the DynamicRequestParameter with the given name.
This method can be used to populate all parameters with their values without relying on their ordering.
method ParameterByName(parameterName: String): DynamicRequestParameter
DynamicRequestParameter ParameterByName(String parameterName)
Function ParameterByName(parameterName As String) As DynamicRequestParameter
Parameters:
- parameterName: Parameter name
ReadParameter protected (declared in DynamicRequest)
Reads parameter's value from the provided IMessage instance.
method ReadParameter(message: IMessage; parameter: DynamicRequestParameter)
void ReadParameter(IMessage message, DynamicRequestParameter parameter)
Sub ReadParameter(message As IMessage, parameter As DynamicRequestParameter)
Parameters:
- message: Message used to communicate with the server
- parameter: Method call parameter
UpdateParamsFromRodl (declared in DynamicRequest)
Retrieves the RODL from the server, locates the service and method and populates the DynamicRequest collection with the appropriate parameter definitions required for the remote method call. Any parameters or values defined prior to calling this method will be removed.
method UpdateParamsFromRodl
void UpdateParamsFromRodl()
Sub UpdateParamsFromRodl()
UpdateParamsFromRodlOperation (declared in DynamicRequest)
Populates the DynamicRequest collection with the appropriate parameter definitions required for the remote method call. Any parameters or values defined prior to calling this method will be removed.
Unlike the DynamicRequest method this method doesn't try to obtain the RODL from the server. Instead it takes the needed information from the provided RodlOperation instance.
method UpdateParamsFromRodlOperation(operation: RodlOperation)
void UpdateParamsFromRodlOperation(RodlOperation operation)
Sub UpdateParamsFromRodlOperation(operation As RodlOperation)
Parameters:
- operation: Server method definition
Validate protected (declared in DynamicRequest)
Validates property values of the current DynamicRequest instance. This method is called when the remote method call is sent to the server.
This method validates the RemoteService.RemoteService settings and ensures that the RemoteService.MethodName property is set.
method Validate
void Validate()
Sub Validate()
WriteParameter protected (declared in DynamicRequest)
Writes parameter name, type and value to the provided IMessage instance.
method WriteParameter(message: IMessage; parameter: DynamicRequestParameter)
void WriteParameter(IMessage message, DynamicRequestParameter parameter)
Sub WriteParameter(message As IMessage, parameter As DynamicRequestParameter)
Parameters:
- message: Message used to communicate with the server
- parameter: Remote method call parameter