9 The SQL Server Data Provider : Connection String Options

Connection String Options
Connection string options can be defined directly in a connection string, or set in the Advanced Properties dialog box in Visual Studio (see “Setting SQL Server Data Provider Connection Options in Server Explorer”.
Constructing a Connection String
“SQL Server Data Provider Connection String Options” lists the connection string options supported by the SQL Server data provider, and describes each option. The options have the form:
option=value
Each connection string option value pair is separated by a semicolon. For example:
"Host=Accounting1;User ID=mike;Password=bogey;Database Name=Accounting"
NOTES:
Setting SQL Server Data Provider Connection Options in Server Explorer
See “Creating a New Connection in Server Explorer” for more information about using Visual Studio to add and modify connections.
To add a connection:
1
Right-click the Data Connections node, and select Add Connection... The Add Data Source window appears.
Default value is displayed in the Port fields of the Add Connection window.
Do one of the following steps:
If the SQL Server data provider is not selected, click Change. The Change Data Source window appears.
2
The Choose Data Source window has Progress DataDirect selected in the Data source list box. The Progress DataDirect Connect for ADO.NET SQL Server data provider is selected in the Data provider drop-down list.
Do the following steps:
a
a
In the Data provider drop-down list, select Progress DataDirect Connect for ADO.NET SQL Server Data Provider.
b
c
If the Progress DataDirect Connect for ADO.NET SQL Server data provider is not listed in the Data provider drop-down list, use the Visual Studio Provider Integration Tool, located in the DataDirect Connect for ADO.NET program group. The product installation automatically integrates the data providers into Visual Studio. If you install the data providers before installing Visual Studio, or uninstall and reinstall Visual Studio, the DataDirect data providers will not appear in the Data provider drop-down list until you use the Visual Studio Provider Integration Tool.
d
Click OK. The Add Connection window appears.
3
If you select Standard Connection, select the host name from the drop-down list in the Host field; then, type the port number in the Port field (see “Port”).
If you select Named Instance Connection, type the host name and the SQL Server named instance to which to you want to connect in the Host and Instance fields.
4
Select Use Kerberos Authentication to enable Kerberos authentication. You do not need to enter a User ID or Password.
Select Use Windows authentication to use NTLM authentication. You do not need to enter a User ID or Password.
Select Use SQL Server Authentication to use the SQL Server UserID/Password authentication. You must enter a SQL Server user ID and password.
5
6
7
8
Click Advanced... to specify additional provider-specific property values. Then, click OK.
The Advanced Properties window shows values for several properties.
To change the values in the Advanced Properties window, type a value into the field or select a value from a drop-down list. The value that appears in the field below the description of the property is added to the connection string. If you accept the default values, the connection string field remains unchanged. The properties are grouped in the list box in categories. See “SQL Server Data Provider Connection String Options” for a complete list of the properties and their descriptions.
9
Click Test Connection. At any point during the configuration process, you can click Test Connection to attempt to connect to the data source using the connection properties specified in the Add Connection dialog box.
NOTE: If you are configuring alternate servers for use with the connection failover feature, be aware that the Test Connection button tests only the primary server, not the alternate servers.
10
Click OK or Cancel to close the Add Connection window. If you click OK, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.
Default Values for Connection String Options
The connection string options are described in “SQL Server Data Provider Connection String Options”. Table 9-1 lists the connection string options the Sybase data providers support.
0x10 or ShowParameterDirections