2022年2022年连接字符串[归 .pdf
ConnectionString 属性关键字默认值说明应用程序名称N/A 应用程序的名称，或者“.Net SqlClient Data Provider” （如果不提供应用程序名称）。Async false 如果设置为true，则启用异步操作支持。可识别的值为true、false、yes和 no 。AttachDBFilename - 或 - extended properties - 或 - Initial File Name N/A 主数据库文件的名称，包括可连接数据库的完整路径名。只有具有 .mdf 扩展名的主数据文件才支持AttachDBFilename。如果主数据文件为只读，则附加操作将失败。该路经可以是绝对路径，也可以是相对路径，这取决于是否使用DataDirectory 替换字符串。 如果使用DataDirectory，则对应的数据库文件必须存在于替换字符串指向的目录的子目录中。说明：远程服务器、 HTTP 及 UNC 路径名不受支持。必须按照如下方式使用关键字“database”（或其别名之一）指定数据库名称：AttachDbFileName=|DataDirectory|dataYourDB.mdf;integrated security=true;database=YourDatabase如果数据文件所在的目录中存在日志文件，并且在附加主数据文件时使用了 “database”关键字，则会生成错误。这种情况下，请移除日志文件。附加了数据库后， 系统将根据物理路径自动生成一个新的日志文件。Connect Timeout - 或 - Connection Timeout 15 在终止尝试并产生错误之前，等待与服务器的连接的时间长度（以秒为单位）。Context Connection false 如果应对SQL Server 进行进程内连接，则为true。Current Language N/A SQL Server 语言记录名称。Data Source - 或 - Server - 或 - Address - 或 - N/A 要连接的SQL Server 实例的名称或网络地址。可以在服务器名称之后指定端口号：server=tcp:servername, portnumber指定本地实例时，始终使用(local)。若要强制使用某个协议，请添加下列前缀之一：np:(local), tcp:(local), lpc:(local)名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 20 页 - - - - - - - - - Addr - 或 - Network Address 说明：ADO.NET 2.0 不支持在SQL Server 2000 或更低版本的共享内存上执行异步命令。但是，可以强制用TCP 代替共享内存， 方法是：向连接字符串中的服务器名称添加“tcp: ”前缀，或者使用 “ 本地主机 ” 。Encrypt false 当该值为true时，如果服务器端安装了证书，则 SQL Server 将对所有在客户端和服务器之间传送的数据使用SSL 加密。可识别的值为 true、false、yes和 no 。Enlist false true表明 SQL Server 连接池程序在创建线程的当前事务上下文中自动登记连接。Failover Partner N/A 在其中配置数据库镜像的故障转移合作伙伴服务器的名称。.NET Framework 1.0 或 1.1 版不支持Failover Partner 关键字。Initial Catalog - 或 - Database N/A 数据库的名称。Integrated Security - 或 - Trusted_Connection false 当为 false时，将在连接中指定用户ID 和密码。当为true时，将使用当前的Windows 帐户凭据进行身份验证。可识别的值为true、false、 yes 、no以及与true等效的sspi（强烈推荐）。MultipleActiveResultSets false 如果为true，则应用程序可以维护多活动结果集(MARS) 。如果为 false，则应用程序必须在执行该连接上的任何其他批处理之前处理或取消一个批处理中的多个结果集。可识别的值为true和 false。.NET Framework 1.0 或 1.1 版不支持该关键字。Network Library - 或 - Net dbmssocn 用于建立与SQL Server 实例的连接的网络库。支持的值包括：dbnmpntw（命名管道）dbmsrpcn（多协议， Windows RPC）dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn（共享内存）dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 20 页 - - - - - - - - - 相应的网络DLL 必须安装在要连接的系统上。如果不指定网络而使用一个本地服务器（比如“.”或“(local)”），则使用共享内存。在此示例中，网络库为Win32 Winsock TCP/IP (dbmssocn)，使用的端口为1433 。复制代码Network Library=dbmssocn;Data Source=000.000.000.000,1433; Packet Size 8192 用来与SQL Server 的实例进行通信的网络数据包的大小，以字节为单位。Password - 或 - Pwd N/A SQL Server 帐户登录的密码。建议不要使用。为保持高安全级别，我们强烈建议您使用Integrated Security或Trusted_Connection关键字。Persist Security Info false 当该值设置为false或 no （强烈推荐）时，如果连接是打开的或者一直处于打开状态，那么安全敏感信息 （如密码）将不会作为连接的一部分返回。 重置连接字符串将重置包括密码在内的所有连接字符串值。可识别的值为true、false、yes和 no 。Replication false 如果使用连接来支持复制，则为true。Transaction Binding Implicit Unbind 控制与登记的System.Transactions事务关联的连接。可能的值包括：Transaction Binding=Implicit Unbind;Transaction Binding=Explicit Unbind;Implicit Unbind 可使连接在事务结束时从事务中分离。分离后，连接上的其他请求将以自动提交模式执行。在事务处于活动状态的情况下执行请求时，不会检查System.Transactions.Transaction.Current属性。 事务结束后，其他请求将以自动提交模式执行。Explicit Unbind 可使连接保持连接到事务，直到连接关闭或调用显式 SqlConnection.TransactionEnlist(null)。如果Transaction.Current不是登记的事务或登记的事务未处于活动状态，则引发InvalidOperationException。TrustServerCertificate false 如果设置为true，则使用SSL 对通道进行加密，但不通过证书链对可信度进行验证。 如果将TrustServerCertificate 设置为true并将 Encrypt 设置为false，则不对通道进行加密。可识别的值为true、false、yes和 no 。有关更多信息，请参见连接字符串语法 (ADO.NET)。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 20 页 - - - - - - - - - Type System Version N/A 指示应用程序期望的类型系统的字符串值。可能的值包括：Type System Version=SQL Server 2000;Type System Version=SQL Server 2005;Type System Version=SQL Server 2008;Type System Version=Latest;如果设置为SQL Server 2000，将使用SQL Server 2000 类型系统。与SQL Server 2005 实例连接时，执行下列转换：XML 到 NTEXT UDT 到 VARBINARY VARCHAR(MAX)、NVARCHAR(MAX) 和 VARBINARY(MAX) 分别到TEXT 、NEXT 和 IMAGE 。如果设置为SQL Server 2005，将使用SQL Server 2005 类型系统。对ADO.NET 的当前版本不进行任何转换。如果设置为Latest，将使用此客户端- 服务器对无法处理的最新版本。这个最新版本将随着客户端和服务器组件的升级自动更新。User ID N/A SQL Server 登录帐户。建议不要使用。为保持高安全级别，我们强烈建议您使用Integrated Security或Trusted_Connection关键字。User Instance false 一个值，用于指示是否将连接从默认的SQL Server 速成版实例重定向到调用方帐户下运行的运行时启动的实例。Workstation ID 本地计算机名称连接到SQL Server 的工作站的名称。ConnectionString内连接池值的有效名称：名称默认值说明Connection Lifetime 0 当连接被返回到池时，将其创建时间与当前时间作比较，如果时间长度（以秒为单位）超出了由Connection Lifetime指定的值，该连接就会被销毁。这在聚集配置中很有用（用于强制执行运行中的服务器和刚置于联机状态的服务器之间的负载平衡）。零 (0) 值将使池连接具有最大的连接超时。Enlist true 当该值为true时，池程序在创建线程的当前事务上下文中自动登记连接。可识别的值为true、false、yes和 no 。Load Balance Timeout 0 连接被销毁前在连接池中生存的最短时间（以秒为单位）。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 20 页 - - - - - - - - - Max Pool Size 100 池中允许的最大连接数。Min Pool Size 0 池中允许的最小连接数。Pooling true 当该值为true时，系统将从适当的池中提取SQLConnection对象，或在需要时创建该对象并将其添加到适当的池中。可识别的值为true、false、yes和 no 。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 20 页 - - - - - - - - - Connection strings for MySQL My SQLCo nn e ct o r / Ne tType: .NET Framework Class Library Usage: MySql.Data.MySqlClient.MySqlConnection 标准连接Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;默认端口是 3306 指定端口连接Server =myServerAddress; Port =1234; Database=myDataBase;Uid=myUsername;Pwd =myPassword;命名管道连接Server =myServerAddress; Port =-1; Database=myDataBase;Uid=myUsername;Pwd =myPassword;说明：端口值为 -1 ，说明用命名管道方式连接。此方式只在Windows下有效，在UNIX下用会被忽略。多服务器连接用此种方式连接到数据库中，不必担心该使用哪个数据库。Server =serverAddress1 & serverAddress2 & etc.;Database=myDataBase;Uid =myUsername; Pwd =myPassword;加密连接这条活动的 SSL连接加密所有客户端和服务器商的数据传输，而且服务器要有一个证书。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Encryption=true;这个选项从 Connector/NET5.0.3版开始出现，以前的版本中则没有此功能。加密技术（供替代的）上述的加密连接如报告一些问题，尝试把 Encryption替换成 Encrypt。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Encrypt =true;指定默认的命令超时时间指定连接的默认命令超时时间，注意：此条不会影响你在单独命令对象上设置的超时时间。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;default command timeout =20;此条只对 Connector/NET 5.1.4 及以上的版本有效. 指定尝试再次连接时间在终止尝试并产生错误之前，等待与服务器的连接的时间长度（以秒为单位）。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Connection Timeout =5;Inactivating prepared statements 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 20 页 - - - - - - - - - Use this one to instruct the provider to ignore any command prepare statements and prevent corruption issues with server side prepared statements. Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Ignore Prepare =true;此选项被加入到Connector/NET 的 5.0.3版和 1.0.9版。指定端口连接使用此来指定要使用的端口的连接。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Port =3306;默认端口是 3306。此参数会被Unix 忽略。指定网络协议连接这条语句修改用哪种协议进行连接。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword; Protocol=socket;如果没有特别说明，socket是默认的值。 tcp 是与 socket相同意义的。 pipe 是使用命名管道连接，unix 是使用 unix socket连接， memory是使用 mySql 的共享内存。指定字符集的连接这个语句指出以哪种字符串编码发送到服务器上的查询语句。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword; CharSet =UTF8;注意：查询结果仍然是以返回数据的格式传送。指定共享内存名此语句用来修改用来通信的共享内存名称。Server =myServerAddress; Database=myDataBase;Uid=myUsername;Pwd =myPassword;Shared Memory Name =MYSQL;说明：此语句只有当连接协议设置为memory时才有效。e I nf o De s i g n s. d bPr o v i d e rType: .NET Framework Class Library Usage: eInfoDesigns.dbProvider.MySqlClient.MySqlConnection 标准连接Data Source =myServerAddress; Database=myDataBase;User ID =myUsername;Password=myPassword; Command Logging=false;Se ve n Ob j ec t sMySql Cl i e ntType: .NET Framework Class Library Usage:标准连接Host=myServerAddress; UserName =myUsername;Password=myPassword;Database=myDataBase;名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 20 页 - - - - - - - - - d o t Co nn e ct f o r My SQL ( f or mer My Di r ec t.NET a n d C or e L ab s My SQLDi r e c t.NET)Type: .NET Framework Class Library Usage: Devart.Data.MySql.MySqlConnection 标准连接User ID =root; Password=myPassword; Host=localhost;Port =3306; Database =myDataBase;Direct =true; Protocol =TCP;Compress=false;Pooling =true; Min Pool Size=0; Max Pool Size =100; Connection Lifetime=0;My SQL Dr i ve r CSType: .NET Framework Class Library Usage: MySQLDriverCS.MySQLConnection 标准连接Location =myServerAddress; Data Source =myDataBase;User ID =myUsername;Password=myPassword; Port =3306; Extended Properties=;My SQLOL EDBType: OLE DB Provider Usage: Provider=MySQLProv 标准连接Provider =MySQLProv;Data Source =mydb;User Id =myUsername;Password=myPassword;. NETFr a me wor kDat aPr ov i de rf o rOLEDBType: .NET Framework Wrapper Class Library Usage: System.Data.OleDb.OleDbConnection 连接 MySQL OLEDB 这只是其中一个包装OleDbConnection类，调用底层OLEDB 提供程序字符串示例。有关更多连接字符串查看各自的 OLE DB提供程序使用这个类。Provider =MySQLProv;Data Source =mydb;User Id =myUsername;Password=myPassword;My ODBC 2. 5 0Type: ODBC Driver Usage: Driver=mySQL 本地数据库连接Driver =mySQL;Server =localhost;Option =16834; Database=myDataBase;远程数据连接名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 20 页 - - - - - - - - - Driver =mySQL;Server =myServerAddress; Option =131072; Stmt=; Database =myDataBase;User=myUsername;Password=myPassword;指定 TCP/IP 端口连接Driver =mySQL;Server =myServerAddress; Port =3306; Option =131072; Stmt =; Database =myDataBase;User=myUsername;Password=myPassword;说明：此 Driver的默认端口是3306。如果没有在连接字符串中特别指出就是连接Mysql 的 3306 端口。My SQLCo nn e ct o r / ODBC 3. 5 1Type: ODBC Driver Usage: Driver=MySQL ODBC 3.51 Driver 本地数据库连接Driver =MySQL ODBC 3.51 Driver;Server =localhost;Database=myDataBase;User=myUsername;Password=myPassword;Option =3;远程数据连接Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; Database=myDataBase;User=myUsername;Password=myPassword;Option =3;指定 TCP/IP 端口连接Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; Port =3306; Database=myDataBase;User=myUsername;Password=myPassword;Option =3;说明：此 Driver的默认端口是3306。如果没有在连接字符串中特别指出就是连接Mysql 的 3306 端口。指定字符集的连接Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; charset =UTF8;Database=myDataBase;User=myUsername;Password=myPassword;Option =3;请注意，这个选项工作于3.51.17版本驱动程序。指定 socket协议连接指定 Unix socket文件或 Windows pipe连接. ，只用于本地客户端连接。Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; Database=myDataBase;User=myUsername;Password=myPassword;Socket =MySQL; Option =3;在 Windows中， socket 的值是命名管道在本地客户端连接使用的名称。默认值是MySQL 。在 Unix 平台上，socket 的值是套接字文件的本地客户端连接使用的名称。默认为 / tmp 目录 / mysql.sock 。使用 SSL 连接Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; Database=myDataBase;User=myUsername;Password=myPassword;sslca =c:cacert.pem;sslcert=c:client-cert.pem;sslkey =c:client-key.pem;sslverify=1; Option =3;SSLCA 指定一个信任的SSL核证机关文件清单的路径名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 20 页 - - - - - - - - - SSLCERT 指定 SSL证书文件的名称用于建立一个安全连接。SSLKEY指定 SSL密钥文件名用于建立一个安全连接。My SQLCo nn e ct o r / ODBC 5. 1Type: ODBC Driver Usage: Driver=MySQL ODBC 5.1 Driver 本地数据库连接Driver =MySQL ODBC 5.1 Driver;Server =localhost;Database=myDataBase; User =myUsername; Password=myPassword;Option =3;远程数据连接Driver =MySQL ODBC 5.1 Driver;Server =myServerAddress; Database=myDataBase; User=myUsername;Password=myPassword;Option =3;指定 TCP/IP 端口连接Driver =MySQL ODBC 5.1 Driver;Server =myServerAddress; Port =3306; Database=myDataBase;User=myUsername;Password=myPassword;Option =3;说明：此 Driver的默认端口是3306。如果没有在连接字符串中特别指出就是连接Mysql 的 3306 端口。指定字符集的连接Driver =MySQL ODBC 5.1 Driver;Server =myServerAddress; charset =UTF8;Database=myDataBase;User=myUsername;Password=myPassword;Option =3;指定 socket协议连接指定 Unix socket文件或 Windows pipe连接. ，只用于本地客户端连接。Driver =MySQL ODBC 5.1 Driver;Server =myServerAddress; Database=myDataBase; User=myUsername;Password=myPassword;Socket =MySQL; Option =3;在 Windows中， socket 的值是命名管道在本地客户端连接使用的名称。默认值是MySQL 。在 Unix 平台上，socket 的值是套接字文件的本地客户端连接使用的名称。默认为 / tmp 目录 / mysql.sock 。使用 SSL 连接Driver =MySQL ODBC 3.51 Driver;Server =myServerAddress; Database=myDataBase;User=myUsername;Password=myPassword;sslca =c:cacert.pem;sslcert=c:client-cert.pem;sslkey =c:client-key.pem;sslverify=1; Option =3;SSLCA 指定一个信任的SSL核证机关文件清单的路径SSLCERT 指定 SSL证书文件的名称用于建立一个安全连接。SSLKEY指定 SSL密钥文件名用于建立一个安全连接。. NETFr a me wor kDat aPr ov i de rf o rODBC名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 20 页 - - - - - - - - - Type: .NET Framework Wrapper Class Library Usage: System.Data.Odbc.OdbcConnection 连接 MySQL Connector/ODBC 5.1 这只是其中一个包装OleDbConnection类，调用底层OLEDB 提供程序字符串示例。有关更多连接字符串查看各自的 OLE DB提供程序使用这个类。Driver =MySQL ODBC 5.1 Driver;Server =localhost;Database=myDataBase;User=myUsername;Password=myPassword;Option =3; 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 20 页 - - - - - - - - - Connection strings for Excel 2007 ACE OLEDB 1 2. 0Type: OLE DB Provider Usage: Provider=Microsoft.ACE.OLEDB.12.0Xlsx 文件这是用来连接带Xlsx 扩展名的 Excel 2007文件，这是不带宏的Office Open XML格式。Provider =Microsoft.ACE.OLEDB.12.0;Data Source =c:myFoldermyExcel2007file.xlsx;Extended Properties=Excel 12.0 Xml;HDR=YES;HDR=yes; 是说第一行是列名而不是数据。HDR=No;正好与前面的相反。把数据全部转化为文本格式使用这条连接当你想把所有的数据都当做文本对待时，覆盖Excel 通常的猜测这列的数据类型。Provider =Microsoft.ACE.OLEDB.12.0;Data Source =c:myFoldermyExcel2007file.xlsx;Extended Properties=Excel 12.0 Xml;HDR=YES;IMEX=1;如果你想把列名也读到结果集中( 使用“ HDR=NO”尽管第一行是列名) 并且列中的数据是数值型的，使用“IMEX=1 ”可必免冲突。使用 IMEX=1检索混合数据列是一种安全的方法。试想一下， 当 Driver检索出数据列中有一种数据类型的excel 文件可以正常工作，而另一个excel 文件 ( 某列 ) 被检测出两种类型，这会造成你的程序的冲突。Xlsb 文件这是用来连接带Xlsb 扩展名的 Excel 2007 文件，这是一种保存为二进制的Office Open XML 格式。不像Xlsx 文件那种可读的文件格式。此种格式在数据量大时可以提升性能。Provider =Microsoft.ACE.OLEDB.12.0;Data Source =c:myFoldermyBinaryExcel2007file.xlsb; Extended Properties=Excel 12.0;HDR=YES;HDR=yes; 是说第一行是列名而不是数据。HDR=No;正好与前面的相反。Xlsm 文件这是用来连接带Xlsm 扩展名的 Excel 2007文件，这是带宏的Office Open XML格式。Provider =Microsoft.ACE.OLEDB.12.0;Data Source =c:myFoldermyExcel2007file.xlsm;Extended Properties=Excel 12.0 Macro;HDR=YES;注意：字符串中的引号要用你的程序的语言的转义语法转义一下。在 C#,C+中为 VB,VBScript为 XML(Web.config 等) 为" 或者可以使用单引号。HDR=yes; 是说第一行是列名而不是数据。HDR=No;正好与前面的相反。. NETFr a me wor kDat aPr ov i de rf o rOLEDBType: .NET Framework Wrapper Class Library Usage: System.Data.OleDb.OleDbConnection 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 20 页 - - - - - - - - - 连接 ACE OLEDB 12.0 这只是其中一个包装OleDbConnection类，调用底层OLEDB 提供程序字符串示例。有关更多连接字符串查看各自的 OLE DB提供程序使用这个类。Provider =Microsoft.ACE.OLEDB.12.0;Data Source =c:myFoldermyExcel2007file.xlsx;Extended Properties=Excel 12.0 Xml;HDR=YES;. NETxl Rea d erf o rMi c r os o f tEx c elType: .NET Framework Class Library Usage: VM.xPort.ExcelClient.ExcelConnection 第一行是列名而不是数据Data Source =c:myExcelFile.xlsx;HDR =yes; Format=xlsx;第一行是数据Data Source =c:myExcelFile.xlsx;HDR =no; Format=xlsx;名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 20 页 - - - - - - - - - Connection strings for ExcelMi cr o so f tJ etOL E DB 4. 0Type: OLE DB Provider Usage: Provider=Microsoft.Jet.OLEDB.4.0标准连接Provider =Microsoft.Jet.OLEDB.4.0;Data Source =C:MyExcel.xls;Extended Properties=Excel 8.0;HDR=Yes;IMEX=1;标准连接（供替代的）Try this on
