2/04/2011

SqlConnection Connection String Parameter Keywords & Values

(Copied from Wayne Allen’s blog,
http://weblogs.asp.net/wallen/archive/2005/03/22/395496.aspx.)


Name



Default




Description



Application Name


 


The name of the application, or '.Net SqlClient Data Provider' if no application name is provided.


AttachDBFilename
-or-
extended properties
-or-
Initial File Name


 


The name of the primary file, including the full path name, of an attachable database. If this setting is specified, the
Initial Catalog setting must also be specified.

The database name must be specified with the keyword 'database'.

Example:
Data Source=.; Initial Catalog=; Integrated Security=true;AttachDBFileName=c:\MyFolder\MyDb.mdf 

Update:

You can use the following syntax to attach a database that lives in your "Data" directory:

AttachDBFileName=|DataDirectory|MyDb.mdf 


Connect Timeout
-or-
Connection Timeout


15


The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.


Current Language


 


The SQL Server Language record name.


Data Source
-or-
Server
-or-
Address
-or-
Addr
-or-
Network Address


 


The name or network address of the instance of SQL Server to which to connect.


Encrypt


'false'


When
true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Recognized values are
true, false, yes, and no.


Initial Catalog
-or-
Database


 


The name of the database.


Integrated Security
-or-
Trusted_Connection


'false'


When
false, User ID and Password are specified in the connection. When
true, the current Windows account credentials are used for authentication.



Recognized values are
true, false, yes, no, and sspi (strongly recommended), which is equivalent to
true.


Network Library
-or-
Net


'dbmssocn'


The network library used to establish a connection to an instance of SQL Server. Supported values include dbnmpntw (Named Pipes), dbmsrpcn (Multiprotocol), dbmsadsn (Apple Talk), dbmsgnet (VIA), dbmslpcn (Shared Memory) and dbmsspxn (IPX/SPX), and dbmssocn (TCP/IP).



The corresponding network DLL must be installed on the system to which you connect. If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used.


Packet Size


8192


Size in bytes of the network packets used to communicate with an instance of SQL Server.


Password
-or-
Pwd


 


The password for the SQL Server account logging on (Not recommended. To maintain a high level of security, it is strongly recommended that you use the Integrated Security or Trusted_Connection keyword instead.).


Persist Security Info


'false'


When set to
false or no (strongly recommended), security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. Resetting the connection string resets all connection string values including the password. Recognized values are
true, false, yes, and no.


User ID


 


The SQL Server login account (Not recommended. To maintain a high level of security, it is strongly recommended that you use the Integrated Security or Trusted_Connection keyword instead.).


Workstation ID


the local computer name


The name of the workstation connecting to SQL Server.


Connection Lifetime


0


When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by
Connection Lifetime. This is useful in clustered configurations to force load balancing between a running server and a server just brought online.



A value of zero (0) causes pooled connections to have the maximum connection timeout.


Connection Reset


'true'


Determines whether the database connection is reset when being drawn from the pool. For Microsoft SQL Server version 7.0, setting to
false avoids making an additional server round trip when obtaining a connection, but you must be aware that the connection state, such as database context, is not being reset.


Enlist


'true'


When
true, the pooler automatically enlists the connection in the creation thread's current transaction context. Recognized values are
true, false, yes, and no.


Max Pool Size


100


The maximum number of connections allowed in the pool.


Min Pool Size


0


The minimum number of connections allowed in the pool.


Pooling


'true'


When
true, the SQLConnection object is drawn from the appropriate pool, or if necessary, is created and added to the appropriate pool. Recognized values are
true, false, yes, and no.

No comments: