Handler Property (RDS)

  • Article

Indicates the name of a server-side customization program (handler) that extends the functionality of the RDSServer.DataFactory, and any parameters used by the handler.

Applies To: DataControl Object (RDS)

Important

Beginning with Windows 8 and Windows Server 2012, RDS server components are no longer included in the Windows operating system (see Windows 8 and Windows Server 2012 Compatibility Cookbook for more detail). RDS client components will be removed in a future version of Windows. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Applications that use RDS should migrate to WCF Data Service.

Syntax

  
DataControl.Handler = String

Parameters

DataControl
An object variable that represents an RDS.DataControl object.

String
A String value that contains the name of the handler and any parameters, all separated by commas (for example, "handlerName,parm1,parm2,...,parmN").

Remarks

This property supports customization, a functionality that requires setting the CursorLocation property to adUseClient.

The name of the handler and its parameters, if any, are separated by commas (","). Unpredictable behavior will result if a semicolon (";") appears anywhere within String. You can write your own handler, provided it supports the IDataFactoryHandler interface.

The name of the default handler is MSDFMAP.Handler, and its default parameter is a customization file named MSDFMAP.INI. Use this property to invoke alternate customization files created by your server administrator.

The alternative to setting the Handler property is to specify a handler and parameters in the ConnectionString property; that is, "Handler=handlerName,parameter1,parameter2,...;".

Applies To

DataControl Object (RDS)

See Also

Handler Property Example (VB)
DataFactory Customization
DataFactory Object (RDSServer)