Customization File Connect Section

The default behavior of the handler is to deny all connections. The connect section specifies exceptions to that behavior. For example, if all the connect sections were absent or empty, then by default no connections could be made.

The connect section can contain:

  • A default access entry that specifies the default read and write operations allowed on this connection. If there is no default access entry in the section, the section will be ignored.

  • A new connection string that replaces the client connection string.

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

A default access entry is of the form:

  
Access=  
accessRight  
  

A replacement connection string entry is of the form:

  
Connect=  
connectionString  
  

Remarks

Part Description
Connect A literal string that indicates this is a connection string entry.
connectionString A string that replaces the whole client connection string.
Access A literal string that indicates this is an access entry.
accessRight One of the following access rights:

- NoAccess - User cannot access the data source.
- ReadOnly - User can read the data source.
- ReadWrite - User can read or write to the data source.

If you want to allow any connection (in effect, disabling the default handler behavior), set the access entry in the connect default section to Access=ReadWrite, and delete or comment out any other connect identifier section.

See Also

Customization File Logs Section
Customization File SQL Section
Customization File UserList Section
DataFactory Customization
Required Client Settings
Understanding the Customization File
Writing Your Own Customized Handler