ConnectionString 同様のOLE DB接続文字列を、同じではありません。ADO、またはOLE DB異なると、「永続セキュリティ情報」の値に設定されている場合 はfalse、ユーザー(デフォルト)で設定された接続文字列、返されたが のConnectionString 同一であるが、安全性情報に加えて。「永続セキュリティ情報」が設定されていない場合 はtrueに、それ以外の場合は、SQL Serverの.NET Frameworkデータプロバイダーが残りませんし、接続文字列のパスワードを返しません。
あなたは使用することができる のConnectionString データベースに接続するためのプロパティを。次の例は、一般的な接続文字列を示しています。
新しい SqlConnectionStringBuilderの 実行時に有効な接続文字列の設定。詳細については、 接続文字列を構築します。
接続が閉じているときにのみ設定することができます のConnectionString プロパティを。多くの接続文字列の値は、読み取り専用の属性を対応しています。接続文字列を設定する場合(エラーが検出されない限り)、それはプロパティを更新します。この場合、任意のプロパティを更新しません。SqlConnectionオブジェクトの プロパティが返すに含まれているもののみ のConnectionStringの 設定。
ローカルコンピュータに接続するには、として指定されたサーバ設定「(ローカル)を。」(あなたは、常にサーバーを指定する必要があります。)
接続が閉じリセット のConnectionStringは、 パスワードを含むすべての接続文字列値(および関連する属性)をリセットします。その後、「データベース= AdventureWorksの」が含まれ、かつ、指定された接続文字列は、接続文字列「データソース= myserverの;統合セキュリティリセットした場合たとえば、 = SSPI」を、 データベースの プロパティは、もはや「AdventureWorksの」に設定されていません。
設定後すぐに接続文字列を分析します。それは構文エラーの分析で発見された場合、その後のような実行時例外、生成 ArgumentExceptionがします。接続をオープンしようとしたときにのみ、あなたは他のエラーが見つかります。
基本的な形式は、セミコロンのキー/値のペアによって分離された直列接続されたストリングを含みます。それぞれのキーワードとその値に接続された等号(=)。セミコロンを含むもの、または二重引用符での単一引用符の値を含めるには、値を二重引用符で囲む必要があります。値はセミコロンと二重引用符が含まれている場合、値は単一引用符で囲むことができます。値は二重引用符で始まる場合は、単一引用符を使用することができます。値は単一引用符で始まる場合は逆に、二重引用符を使用することができます。値は両方のシングルと二重引用符が含まれている場合は引用符で囲まれた文字は、それぞれの出現をマークしたときに、値がペアで発生する必要があり、使用されています。
先頭または末尾にスペースを含めるには、値が文字列値に単一引用符または二重引用符で囲む必要があります。先頭または末尾のスペースの周りに引用符でさえ、整数、ブール、または列挙値は無視されます。しかし、キーワードや文字列値にスペースを禁じます。(例えば、データソース= my'Serverまたはデータソース=私の「サーバー)が、引用符を区切り文字を使用せずに、.NET Frameworkの1.1以降のバージョン、接続文字列内の単一引用符または二重引用符を使用する場合、文字は、値の最初または最後の文字ではありません。
キーワードまたは値(=)で等号を含めるには、その前に別の等号を持っている必要があります。例えば、接続文字列を仮定すると、
キーワードは「キー=言葉」であり、値が「値」です。
特定のキーワードでのキー/値のペアは、接続文字列内に複数回表示された場合は、値の最終セットのために表示されます。
キーワードは大文字と小文字を区別しません。
次の表は、一覧表示 のConnectionString に有効な名前キーの値を。
キーワード |
デフォルト値 |
説明 |
|
---|---|---|---|
アプリケーション名 |
N / A |
アプリケーションの名前、または「.NET SqlClientデータプロバイダー」(なしアプリケーション名の場合)。 |
|
非同期 |
「偽の」 |
設定された場合は trueに、操作の非同期のサポートが有効になっています。認識される値 をtrueに、falseに、はい と NO。 |
|
AttachDBFilename - または - 拡張プロパティ - または - 初期ファイル名 |
N / A |
データベースに接続するには、完全なパス名を含めて、プライマリ・データベース・ファイルの名前。パスは、かどうかのDataDirectory置換文字列に応じて、絶対パスまたは相対パスであることができます。DataDirectoryの場合は、対応するデータベース・ファイル・ディレクトリには、置換文字列尖ったサブディレクトリに存在している必要があります。
次のようにデータベース名キーワード「データベース」(またはそのエイリアスのいずれか)を指定する必要があります。 "AttachDbFileName = | DataDirectoryの| \データ\ YourDB.mdf;統合セキュリティ=真;データベース= YourDatabase" |
|
接続タイムアウト - または - 接続タイムアウト |
15 |
終了して(秒)サーバへの接続を待機する時間の長さに誤差が発生する前にしようとしました。 |
|
コンテキスト接続 |
「偽の」 |
応答は、SQL Serverプロセス接続内にあるとした場合、比較 trueに。 |
|
現在の言語 |
N / A |
SQL Serverの言語のレコード名。 |
|
情報源 - または - サーバ - または - 住所 - または - ADDR - または - ネットワークアドレス |
N / A |
に接続するSQL Serverのインスタンスの名前またはネットワークアドレス。あなたは、サーバー名の後にポート番号を指定することができます。 サーバー= TCP:サーバー名、ポート番号 あなたは地元のインスタンスを指定する場合は、必ず(ローカル)を使用します。プロトコルの使用を強制するには、次のプレフィックスのいずれかを追加します。 NP:(ローカル)、TCP:(ローカル)、LPC:(ローカル) |
|
暗号化 |
「偽の」 |
当该值为 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 |
'true' |
如果为 true,则应用程序可以维护多活动结果集 (MARS)。如果为 false,则应用程序必须在执行该连接上的任何其他批处理之前处理或取消一个批处理中的多个结果集。 可识别的值为 true 和 false。 .NET Framework 1.0 或 1.1 版不支持该关键字。 |
|
Network Library - 或 - Net |
'dbmssocn' |
用于建立与 SQL Server 实例的连接的网络库。支持的值包括 dbnmpntw(命名管道)、dbmsrpcn(多协议)、dbmsadsn (Apple Talk)、dbmsgnet (VIA)、dbmslpcn(共享内存)及 dbmsspxn (IPX/SPX) 和 dbmssocn (TCP/IP)。 相应的网络 DLL 必须安装在要连接的系统上。如果不指定网络而使用一个本地服务器(比如“.”或“(local)”),则使用共享内存。 |
|
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。 |
|
TrustServerCertificate |
'false' |
如果设置为 true,则使用 SSL 对通道进行加密,但不通过证书链对可信度进行验证。如果将 TrustServerCertificate 设置为 true 并将 Encrypt 设置为 false,则不对通道进行加密。可识别的值为 true、false、yes 和 no。有关更多信息,请参见 SQL Server 2005 Books Online(《SQL Server 2005 联机丛书》)中的“Encryption Hierarchy”(加密层次结构)和“Using Encryption Without Validation”(使用不验证的加密)。 |
|
Type System Version |
N/A |
指示应用程序期望的类型系统的字符串值。可能的值有: Type System Version=SQL Server 2000; Type System Version=SQL Server 2005; 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 的工作站的名称。 |