SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString Property

定義

SQL Server データベースを開くために使用する文字列を取得または設定します。Gets or sets the string used to open a SQL Server database.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String

プロパティ値

ソース データベース名を含む接続文字列、および初期接続を確立するために必要なその他のパラメーター。The connection string that includes the source database name, and other parameters needed to establish the initial connection. 既定値は空の文字列です。The default value is an empty string.

実装

例外

無効な接続文字列引数が指定されたか、必要な接続文字列引数が指定されていません。An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

次の例では、作成、SqlConnection設定と、ConnectionString接続を開く前に、プロパティ。The following example creates a SqlConnection and sets the ConnectionString property before opening the connection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

注釈

ConnectionString OLE DB 接続文字列に似ていますが、同一ではありません。The ConnectionString is similar to an OLE DB connection string, but is not identical. 返される接続文字列では OLE DB や ADO とは異なり、ユーザー設定と同じConnectionString、Persist Security Info 値に設定されている場合、セキュリティ情報マイナスfalse(既定値)。Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString, minus security information if the Persist Security Info value is set to false (default). .NET Framework Data Provider for SQL Server が永続化または Persist Security Info 設定していない場合、接続文字列にパスワードを返すしていないtrueします。The .NET Framework Data Provider for SQL Server does not persist or return the password in a connection string unless you set Persist Security Info to true.

使用することができます、ConnectionStringプロパティをデータベースに接続します。You can use the ConnectionString property to connect to a database. 次の例では、一般的な接続文字列を示します。The following example illustrates a typical connection string.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

使用して、新しいSqlConnectionStringBuilder実行時に有効な接続文字列を作成します。Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. 詳細については、「接続文字列ビルダー」をご覧ください。For more information, see Connection String Builders.

ConnectionStringプロパティは、接続が閉じられたときにのみ設定できます。The ConnectionString property can be set only when the connection is closed. 多くの接続文字列の値により、対応する読み取り専用プロパティがあります。Many of the connection string values have corresponding read-only properties. 接続文字列が設定されている場合、エラーが検出された場合を除き、これらのプロパティが更新します。When the connection string is set, these properties are updated, except when an error is detected. ここで、プロパティのいずれも更新されます。In this case, none of the properties are updated. SqlConnection プロパティに格納されている設定のみを返す、ConnectionStringします。SqlConnection properties return only those settings that are contained in the ConnectionString.

ローカル コンピューターに接続する場合、サーバーの"(local)"と指定します。To connect to a local computer, specify "(local)" for the server. サーバー名が指定されていない場合は、ローカル コンピューターの既定のインスタンスに接続が試行されます。If a server name is not specified, a connection will be attempted to the default instance on the local computer.

リセット、ConnectionString閉じている接続すべて接続文字列の値 (および関連するプロパティ) など、パスワードをリセットします。Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. などを含む接続文字列を設定した場合"データベース = AdventureWorks"、およびへの接続文字列をリセットし、"データ ソース myserver; = 統合セキュリティ = true"、Databaseプロパティが"AdventureWorks"に設定されて不要になった。For example, if you set a connection string that includes "Database= AdventureWorks", and then reset the connection string to "Data Source=myserver;Integrated Security=true", the Database property is no longer set to "AdventureWorks".

接続文字列が設定されている後すぐに解析されます。The connection string is parsed immediately after being set. 解析中に、ランタイム例外などの構文エラーが見つかった場合ArgumentExceptionが生成されます。If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. 試行、接続を開く場合にのみ、その他のエラーを確認できます。Other errors can be found only when an attempt is made to open the connection.

接続文字列の基本形式には、一連キーワード/値ペアのセミコロンで区切ってにはが含まれています。The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. それぞれのキーワードと値の関連付けには、等号 (=) が使用されます。The equal sign (=) connects each keyword and its value. セミコロン、単一引用符または二重引用符文字が含まれている値を含めるには、値を二重引用符で囲む必要があります。To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. セミコロンと二重引用符文字の両方が、値が含まれる場合、値は単一引用符で囲むことができます。If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. 単一引用符も値が二重引用符文字で始まる場合に役立ちます。The single quotation mark is also useful if the value starts with a double-quote character. 逆に、値が単一引用符で始まる場合は、二重引用符を使用できます。Conversely, the double quotation mark can be used if the value starts with a single quotation mark. 値に単一引用符と二重引用符の両方の文字が含まれている場合は、値内で発生するたびに値を囲むために使用する引用符文字が倍増する必要があります。If the value contains both single-quote and double-quote characters, the quotation mark character used to enclose the value must be doubled every time it occurs within the value.

文字列値の先頭または末尾のスペースを含めるには、単一引用符または二重引用符のいずれかの値を囲む必要があります。To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. 引用符で囲まれている場合でも、整数、ブール値、列挙値の先頭または末尾の空白は無視されます。Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. ただし、文字列リテラル キーワードまたは値内にスペースが保持されます。However, spaces within a string literal keyword or value are preserved. 一重または二重引用符は、区切り記号を使用せず、接続文字列内で使用可能性があります (たとえば、データ ソース = my'Server またはデータ ソース"Server =) 引用符文字が値の最初と最後の文字がない限り、します。Single or double quotation marks may be used within a connection string without using delimiters (for example, Data Source= my'Server or Data Source= my"Server), unless a quotation mark character is the first or last character in the value.

キーワードは、大文字小文字が区別されません。Keywords are not case sensitive.

次の表には、内のキーワード値の有効な名前が一覧表示、ConnectionStringします。The following table lists the valid names for keyword values within the ConnectionString.

キーワードKeyword 既定値Default 説明Description
AddrAddr N/AN/A シノニムのデータソースします。Synonym of Data Source.
アドレスAddress N/AN/A シノニムのデータソースします。Synonym of Data Source.
アプリApp N/AN/A シノニムのアプリケーション名します。Synonym of Application Name.
Application NameApplication Name N/AN/A アプリケーション、または '.NET SQLClient Data Provider' アプリケーションの名前を指定しない場合の名前。The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

アプリケーション名は 128 文字以下。An application name can be 128 characters or less.
ApplicationIntent ReadWrite サーバーに接続するときに、アプリケーション ワークロードの種類を宣言します。Declares the application workload type when connecting to a server. 有効な値は、ReadOnlyReadWrite です。Possible values are ReadOnly and ReadWrite. 次に例を示します。For example:

ApplicationIntent=ReadOnly

Always On 可用性グループの SqlClient サポートの詳細については、「高可用性障害復旧のための SqlClient サポート」をご覧ください。For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Asynchronous ProcessingAsynchronous Processing

または-or-

AsyncAsync
'false''false' ときにtrue、非同期操作のサポートを有効にします。When true, enables asynchronous operation support. 認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no.

このプロパティは .NET Framework 4.5.NET Framework 4.5 の開始時に無視されます。This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. 非同期プログラミングの SqlClient サポートの詳細については、次を参照してください。非同期プログラミングします。For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

または-or-

拡張プロパティExtended Properties

または-or-

初期ファイル名Initial File Name
N/AN/A アタッチできるデータベースの完全なパス名を含む、プライマリ データベース ファイルの名前。The name of the primary database file, including the full path name of an attachable database. AttachDBFilename は、.mdf 拡張子を持つプライマリ データ ファイルにのみサポートされます。AttachDBFilename is only supported for primary data files with an .mdf extension.

接続文字列で AttachDBFileName キーの値が指定されている場合、データベースがアタッチされているし、接続の既定のデータベースになります。If the value of the AttachDBFileName key is specified in the connection string, the database is attached and becomes the default database for the connection.

このキーが指定されていないと、データベースが以前にアタッチされている場合は、データベースはアタッチされません。If this key is not specified and if the database was previously attached, the database will not be reattached. 以前接続されているデータベースは、接続の既定のデータベースとして使用されます。The previously attached database will be used as the default database for the connection.

AttachDBFileName キーは、このキーが指定されている場合、エイリアスとしてこのキーの値が使用します。If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. ただし、名前は接続されている別のデータベースで既に使用されて、接続は失敗します。However, if the name is already used in another attached database, the connection will fail.

パスには、DataDirectory 置換文字列を使用して、絶対または相対可能性があります。The path may be absolute or relative by using the DataDirectory substitution string. DataDirectory を使用する場合は、置換文字列を指すディレクトリのサブディレクトリ内にデータベース ファイルが存在する必要があります。If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. 注: リモート サーバー、HTTP、および UNC パス名はサポートされていません。Note: Remote server, HTTP, and UNC path names are not supported.

データベース名は、次のように 'database' キーワード (またはそのエイリアスのいずれか) で指定する必要があります。The database name must be specified with the keyword 'database' (or one of its aliases) as in the following:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

データ ファイルと同じディレクトリにログ ファイルが存在する場合、プライマリ データ ファイルのアタッチ時に 'database' キーワードが使用されると、エラーが生成されます。An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. この場合は、ログ ファイルを削除してください。In this case, remove the log file. データベースがアタッチされると、物理パスに基づいて、新しいログ ファイルが自動的に生成されます。Once the database is attached, a new log file will be automatically generated based on the physical path.
認証Authentication N/AN/A 使用される認証方法SQL データベースを Azure Active Directory 認証を使用する接続します。The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

次の値を指定できます。Valid values are:

Active Directory の統合、Active Directory パスワードで Sql パスワード。Active Directory Integrated, Active Directory Password, Sql Password.
Column Encryption SettingColumn Encryption Setting N/AN/A 有効または無効にAlways Encrypted接続に対して機能します。Enables or disables Always Encrypted functionality for the connection.
接続のタイムアウトConnect Timeout

または-or-

Connection TimeoutConnection Timeout

または-or-

TimeoutTimeout
1615 秒単位で時間の長さ、サーバーへの接続を待機します。The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

有効な値は 0 以上、2147483647 以下。Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Azure SQL データベースへの接続を開くときに、接続のタイムアウトを 30 秒に設定します。When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
接続の有効期間Connection Lifetime

- または --or-

Load Balance TimeoutLoad Balance Timeout
00 接続がプールに返された時点で、その接続の作成時刻と現在の時刻を比較し、その時間の長さ (秒) が Connection Lifetime で指定した値を超えている場合は、その接続が破棄されます。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.

値ゼロ (0) の場合、プールされた接続の最大接続タイムアウトにします。A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 コントロール、再接続試行回数後、クライアントは、アイドル状態の接続エラーを識別します。Controls the number of reconnection attempts after the client identifies an idle connection failure. 有効な値は、0 ~ 255 です。Valid values are 0 to 255. 既定値は 1 です。The default is 1. 0 の場合は、再接続 (接続の回復性を無効にする) にしないでください。0 means do not attempt to reconnect (disable connection resiliency).

アイドル接続の回復の詳細については、次を参照してください。技術記事 - アイドル接続の回復性します。For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 各接続再試行 (ConnectRetryCount) までの時間を指定します。Specifies the time between each connection retry attempt (ConnectRetryCount). 有効な値は 1 ~ 60 秒 (既定 = 10)、最初の再接続の試行後に適用します。Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. クライアントが再接続; をすぐにしようと切断された接続が検出されると、これは最初の再接続の試行であり、ConnectRetryCount が 0 より大きい場合にのみ発生します。When a broken connection is detected, the client immediately attempts to reconnect; this is the first reconnection attempt and only occurs if ConnectRetryCount is greater than 0. ConnectRetryCount が 1 より大きい最初の再接続の試行が失敗した場合、クライアントは、2 回目以降の再接続を試行する ConnectRetryInterval を待機します。If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

アイドル接続の回復の詳細については、次を参照してください。技術記事 - アイドル接続の回復性します。For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Context ConnectionContext Connection 'false''false' true SQL Server に、プロセス内の接続を確立する必要がある場合。true if an in-process connection to SQL Server should be made.
Current LanguageCurrent Language

または-or-

言語Language
N/AN/A データベース サーバーの警告またはエラー メッセージに使用される言語を設定します。Sets the language used for database server warning or error messages.

言語名は 128 文字以下。The language name can be 128 characters or less.
データ ソースData Source

- または --or-

サーバーServer

または-or-

アドレスAddress

- または --or-

AddrAddr

- または --or-

ネットワーク アドレスNetwork Address
N/AN/A 接続先となる SQL Server のインスタンスの名前またはネットワーク アドレス。The name or network address of the instance of SQL Server to which to connect. サーバー名の後にポート番号を指定できます。The port number can be specified after the server name:

server=tcp:servername, portnumber

常にローカル インスタンスを指定するときに、(local) 使用します。When specifying a local instance, always use (local). プロトコルを強制するには、次のプレフィックスのいずれかを追加します。To force a protocol, add one of the following prefixes:

np:(local), tcp:(local), lpc:(local)

以降で.NET Framework 4.5.NET Framework 4.5、次のように LocalDB データベースに接続することができますもします。Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

LocalDB の詳細については、次を参照してください。 SqlClient による LocalDB のサポートします。For more information about LocalDB, see SqlClient Support for LocalDB.

データ ソースTCP 形式または名前付きパイプの形式を使用する必要があります。Data Source must use the TCP format or the Named Pipes format.

TCP の形式は次のとおりです。TCP format is as follows:

-tcp:<ホスト名 >\< インスタンス名>- tcp:<host name>\<instance name>
-tcp:<ホスト名 >、<TCP/IP ポート番号 >- tcp:<host name>,<TCP/IP port number>

TCP の形式は、プレフィックスで始まる必要があります"tcp:"ホスト名とインスタンス名で指定されたデータベースのインスタンスが続きます。The TCP format must start with the prefix "tcp:" and is followed by the database instance, as specified by a host name and an instance name. この形式は、Azure SQL Database に接続するときに適用されません。This format is not applicable when connecting to Azure SQL Database. プロトコルが指定されていない場合、Azure SQL Database への接続の TCP が自動的に選択します。TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

次の方法のいずれかでは、ホスト名を指定する必要があります。The host name MUST be specified in one of the following ways:

-Netbios 名- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

インスタンス名は、データベース インスタンスがホストされている特定の TCP/IP ポート番号を解決するのには使用されます。The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. または、TCP/IP ポート番号を直接指定することは許可されてもします。Alternatively, specifying a TCP/IP port number directly is also allowed. 両方のインスタンス名、ポート番号が存在しない場合は、既定のデータベース インスタンスが使用されます。If both instance name and port number are not present, the default database instance is used.

名前付きパイプの形式は次のとおりです。The Named Pipes format is as follows:

-np:\\< ホスト名>\pipe\< パイプ名>- np:\\<host name>\pipe\<pipe name>

名前付きパイプの形式は、プレフィックスで始まる必要があります"np:"名前付きパイプ名が続きます。The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

次の方法のいずれかでは、ホスト名を指定する必要があります。The host name MUST be specified in one of the following ways:

-Netbios 名- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

パイプ名は、.NET Framework アプリケーションの接続先のデータベース インスタンスを識別するために使用されます。The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

場合の値、ネットワークキーを指定すると、プレフィックス"tcp:"と"np:"は指定しないでください。If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. 注: いずれかでプレフィックスとして、共有メモリは、代わりに TCP を使用を強制できますtcp: またはを使用して、接続文字列では、サーバー名にlocalhostします。Note: You can force the use of TCP instead of shared memory, either by prefixing tcp: to the server name in the connection string, or by using localhost.
EncryptEncrypt 'false''false' ときにtrue、SQL Server は、サーバーにインストールされている証明書がある場合、クライアントとサーバー間で送信されるすべてのデータに対して SSL 暗号化を使用します。When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. 認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no. 詳細については、次を参照してください。接続文字列の構文します。For more information, see Connection String Syntax.

以降で.NET Framework 4.5.NET Framework 4.5TrustServerCertificateが false とEncryptが true の場合、SQL Server の SSL 証明書にサーバー名 (または IP アドレス) する必要がありますと正確に一致、サーバー名 (または IP アドレス)、接続文字列で指定します。Beginning in .NET Framework 4.5.NET Framework 4.5, when TrustServerCertificate is false and Encrypt is true, the server name (or IP address) in a SQL Server SSL certificate must exactly match the server name (or IP address) specified in the connection string. それ以外の場合、接続試行は失敗します。Otherwise, the connection attempt will fail. 証明書のサブジェクトがワイルドカード文字 (*) で始まるのサポートについては、次を参照してください。サーバー認証のためサーバー証明書でワイルドカードを受け入れるします。For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
EnlistEnlist 'true''true' true SQL Server の接続プーラーが、作成スレッドの現在のトランザクション コンテキストで接続を自動的に登録することを示します。true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Failover PartnerFailover Partner N/AN/A データベース ミラーリングが構成されているフェールオーバー パートナー サーバーの名前。The name of the failover partner server where database mirroring is configured.

このキーの値の場合""、しInitial Catalog存在する必要があり、その値がすることはできません""です。If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

サーバー名は 128 文字以下。The server name can be 128 characters or less.

指定する場合は、データベース ミラーリングのフェールオーバー パートナーがフェールオーバー パートナー サーバーが未構成し、(、Server キーワードで指定)、プライマリ サーバーが使用できないと接続は失敗します。If you specify a failover partner but the failover partner server is not configured for database mirroring and the primary server (specified with the Server keyword) is not available, then the connection will fail.

データベース ミラーリングのフェールオーバー パートナーとプライマリ サーバーが未構成を指定する場合は、プライマリ サーバーが使用可能な場合 (、Server キーワードで指定)、プライマリ サーバーへの接続は成功します。If you specify a failover partner and the primary server is not configured for database mirroring, the connection to the primary server (specified with the Server keyword) will succeed if the primary server is available.
Initial CatalogInitial Catalog

または-or-

データベースDatabase
N/AN/A データベースの名前。The name of the database.

データベース名は 128 文字以下。The database name can be 128 characters or less.
Integrated SecurityIntegrated Security

- または --or-

Trusted_ConnectionTrusted_Connection
'false''false' ときにfalse、ユーザー ID とパスワードが接続に指定します。When false, User ID and Password are specified in the connection. ときにtrue、現在の Windows アカウントの資格情報が認証に使用されます。When true, the current Windows account credentials are used for authentication.

認識できる値はtruefalseyesno、およびsspi(強く推奨)、これに相当trueします。Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

ユーザー ID とパスワードが指定されて、統合された場合、セキュリティが true の場合、ユーザー ID に設定しパスワードは無視され、統合セキュリティを使用します。If User ID and Password are specified and Integrated Security is set to true, the User ID and Password will be ignored and Integrated Security will be used.

SqlCredential SQL Server 認証を使用する接続の資格情報を指定するより安全な方法は、(Integrated Security=false)。SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication (Integrated Security=false).
Max Pool SizeMax Pool Size 100100 プールで許可される接続の最大数。The maximum number of connections that are allowed in the pool.

有効な値は、1 以上です。Valid values are greater than or equal to 1. 値より小さいMin Pool Sizeエラーを生成します。Values that are less than Min Pool Size generate an error.
Min Pool SizeMin Pool Size 00 プールで許可される接続の最小数。The minimum number of connections that are allowed in the pool.

有効な値は 0 以上です。Valid values are greater than or equal to 0. このフィールドにゼロ (0) では、最小の接続が最初に開かれていないことを意味します。Zero (0) in this field means no minimum connections are initially opened.

値を超える最大プール サイズエラーを生成します。Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets 'false''false' ときにtrueアプリケーションが複数のアクティブな結果セット (MARS) を維持することができます。When true, an application can maintain multiple active result sets (MARS). ときにfalseアプリケーションが処理またはその接続で他のバッチを実行するには、1 つのバッチからすべての結果セットを取り消す必要があります。When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

認識できる値はtruefalseします。Recognized values are true and false.

詳細については、「 複数のアクティブな結果セット (MARS)」を参照してください。For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover falseFALSE 常に指定multiSubnetFailover=True可用性グループ リスナーを SQL Server 2012 の (またはそれ以降) の可用性グループまたは SQL Server 2012 (以降) フェールオーバー クラスター インスタンスに接続するとき。Always specify multiSubnetFailover=True when connecting to the availability group listener of a SQL Server 2012 (or later) availability group or a SQL Server 2012 (or later) Failover Cluster Instance. multiSubnetFailover=True SqlClient が迅速に検出し、(現在) アクティブなサーバーに接続を構成します。multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. 指定できる値はYesNoTrueFalseまたは10します。Possible values are Yes and No, True and False or 1 and 0. 例:For example:

MultiSubnetFailover=True

既定値は、False です。The default is False. Ag で常の SqlClient のサポートの詳細については、次を参照してください。高可用性、ディザスター リカバリーのための SqlClient サポートします。For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Network LibraryNetwork Library

または-or-

ネットワークNetwork

または-or-

NetNet
N/AN/A SQL Server のインスタンスへの接続を確立するために使用されるネットワーク ライブラリです。The network library used to establish a connection to an instance of SQL Server. サポートされている値は次のとおりです。Supported values include:

dbnmpntw (名前付きパイプ)dbnmpntw (Named Pipes)

dbmsrpcn (マルチ プロトコル、Windows RPC)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Appletalk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (共有メモリ)dbmslpcn (Shared Memory)

dbmsspxn (IPX/SPX)dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)dbmssocn (TCP/IP)

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

接続先のシステムに、対応するネットワーク DLL がインストールされている必要があります。The corresponding network DLL must be installed on the system to which you connect. ネットワークを指定しないし、ローカル サーバーを使用する場合 (たとえば、"."または"(local)")、共有メモリを使用します。If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. 次の例では、ネットワーク ライブラリが Win32 Winsock TCP/IP (dbmssocn) で、使用ポートは 1433 です。In this example, the network library is Win32 Winsock TCP/IP (dbmssocn), and 1433 is the port being used.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet SizePacket Size 80008000 SQL Server のインスタンスとの通信に使用するネットワーク パケットのバイト サイズ。Size in bytes of the network packets used to communicate with an instance of SQL Server.

パケット サイズが 512 以上にすることができます、32768 以下。The packet size can be greater than or equal to 512 and less than or equal to 32768.
パスワードPassword

または-or-

PWDPWD
N/AN/A SQL Server のログオン アカウントのパスワード。The password for the SQL Server account logging on. お勧めしません。Not recommended. 高レベルのセキュリティを維持するために強くお勧めを使用すること、Integrated SecurityまたはTrusted_Connectionキーワード代わりにします。To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential SQL Server 認証を使用する接続の資格情報を指定するより安全な方法です。SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

パスワードは 128 文字である必要がありますまたはそれ以下。The password must be 128 characters or less.
Persist Security InfoPersist Security Info

または-or-

PersistSecurityInfoPersistSecurityInfo
'false''false' 設定するとfalseまたはno(強く推奨)、接続が開いているか、開いている状態になった場合、接続文字列の一部として、パスワードなどの機密情報が返されません。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. 認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod 自動Auto 接続プールのブロック期間の動作を設定します。Sets the blocking period behavior for a connection pool. 参照してくださいPoolBlockingPeriodについては、プロパティ。See PoolBlockingPeriod property for details.
PoolingPooling 'true''true' このキーの値が新しく作成された、true に設定されている場合、接続は、アプリケーションによって閉じられたときに、プールに追加されます。When the value of this key is set to true, any newly created connection will be added to the pool when closed by the application. 次回、同じ接続を開くでその接続がプールから描画されます。In a next attempt to open the same connection, that connection will be drawn from the pool.

同じ接続文字列がある場合の接続のと同じ自動的に見なされます。Connections are considered the same if they have the same connection string. さまざまな接続では、異なる接続文字列があります。Different connections have different connection strings.

このキーの値が"true"は"false"、"yes"または"no"です。The value of this key can be "true", "false", "yes", or "no".
ReplicationReplication 'false''false' true 場合は、接続を使用して、レプリケーションがサポートされていること。true if replication is supported using the connection.
Transaction BindingTransaction Binding Implicit UnbindImplicit Unbind 参加するいると接続の関連付けを制御System.Transactionsトランザクション。Controls connection association with an enlisted System.Transactions transaction.

指定できる値は次のとおりです。Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

暗黙的なバインドの解除には、終了時に、トランザクションからデタッチへの接続が発生します。Implicit Unbind causes the connection to detach from the transaction when it ends. デタッチ後、接続に対する追加の要求は、自動コミット モードで実行されます。After detaching, additional requests on the connection are performed in autocommit mode. トランザクションがアクティブである間に要求が実行されても、System.Transactions.Transaction.Current プロパティの確認は行われません。The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. トランザクションの終了後、追加の要求は、自動コミット モードで実行されます。After the transaction has ended, additional requests are performed in autocommit mode.

システム トランザクションを終了する場合 (を使用して、スコープ内でブロック) 最後のコマンドが完了する前にスローされますInvalidOperationExceptionします。If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

接続が保たれますが、接続が閉じられるまで、トランザクションまたは明示的なにアタッチされている明示的なバインドの解除エラーの原因SqlConnection.TransactionEnlist(null)が呼び出されます。Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. 以降で.NET Framework 4.NET Framework 4、暗黙的なバインドを解除する変更明示的バインド解除廃止されています。Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. InvalidOperationException が登録済みのトランザクションではない場合および登録済みのトランザクションがアクティブではない場合は、Transaction.Current がスローされます。An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution 説明を参照してください。See description. このキーの値を true に設定すると、特定の DNS エントリのすべての IP アドレスを取得し、リストの最初の IP アドレスで接続を試行するようアプリケーションに要求します。When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. 0.5 秒以内に接続が確立されない場合、アプリケーションは他のすべての IP アドレスへの接続を同時に試行します。If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. 最初の応答を受信すると、アプリケーションは応答した IP アドレスで接続を確立します。When the first answers, the application will establish the connection with the respondent IP address.

場合、MultiSubnetFailoverにキーが設定されているtrueTransparentNetworkIPResolutionは無視されます。If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

場合、Failover Partnerキーを設定すると、TransparentNetworkIPResolutionは無視されます。If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

このキーの値である必要がありますtruefalseyes、またはnoします。The value of this key must be true, false, yes, or no.

yesは同じの値には扱わtrueします。A value of yes is treated the same as a value of true.

noは同じの値には扱わfalseします。A value of no is treated the same as a value of false.

既定値は次のとおりです。The default values are as follows:

  • false いつ:false when:

    • データ ソースが終わる、Azure SQL Database への接続。Connecting to Azure SQL Database where the data source ends with:

      • .database.chinacloudapi.cn.database.chinacloudapi.cn
      • .database.usgovcloudapi.net.database.usgovcloudapi.net
      • .database.cloudapi.de.database.cloudapi.de
      • .database.windows.net.database.windows.net
    • Authentication 'Active Directory パスワード' または ' Active Directory が統合です 'Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true。上記のいずれのケースにも該当しない場合。true in all other cases.
TrustServerCertificateTrustServerCertificate 'false''false' 設定するとtrue信頼性を検証する証明書チェーンのウォークをバイパスするときに、チャネルを暗号化に SSL を使用します。When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. TrustServerCertificate に設定されている場合trueに暗号化が設定されているとfalseチャネルは暗号化されません。If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. 認識される値は truefalseyes および no です。Recognized values are true, false, yes, and no. 詳細については、次を参照してください。接続文字列の構文します。For more information, see Connection String Syntax.
型システムのバージョンType System Version N/AN/A 型システムを示す文字列値、アプリケーションが必要です。A string value that indicates the type system the application expects. クライアント アプリケーションで利用可能な機能は、SQL Server のバージョンとデータベースの互換性レベルに依存します。The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. 使用されている SQL Server のバージョンが、クライアント アプリケーションで想定されているものと異なる場合、アプリケーションが正常に動作しない可能性がありますが、型システムのバージョンを明示的に設定することでその問題を防ぐことができます。Explicitly setting the type system version that the client application was written for avoids potential problems that could cause an application to break if a different version of SQL Server is used. 注: SQL Server でインプロセスで実行される共通言語ランタイム (CLR) コードに対して型システムのバージョンを設定することはできません。Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. 詳細については、次を参照してください。 SQL Server 共通言語ランタイム統合します。For more information, see SQL Server Common Language Runtime Integration.

指定できる値は次のとおりです。Possible values are:

Type System Version=SQL Server 2012;

Type System Version=SQL Server 2008;

Type System Version=SQL Server 2005;

Type System Version=Latest;

Type System Version=SQL Server 2012; バージョン 11.0.0.0 Microsoft.SqlServer.Types.dll のアプリケーションを要求することを指定します。Type System Version=SQL Server 2012; specifies that the application will require version 11.0.0.0 of Microsoft.SqlServer.Types.dll. 他のType System Version設定 Microsoft.SqlServer.Types.dll の version 10.0.0.0 が必要になります。The other Type System Version settings will require version 10.0.0.0 of Microsoft.SqlServer.Types.dll.

Latest 廃止され、使用する必要があります。Latest is obsolete and should not be used. LatestType System Version=SQL Server 2008; と同じです。Latest is equivalent to Type System Version=SQL Server 2008;.
User IDUser ID

- または --or-

UIDUID

または-or-
N/AN/A SQL Server ログイン アカウント。The SQL Server login account. お勧めしません。Not recommended. 高レベルのセキュリティを維持するために強くお勧めを使用すること、Integrated SecurityまたはTrusted_Connectionキーワード代わりにします。To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential SQL Server 認証を使用する接続の資格情報を指定するより安全な方法です。SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

ユーザー ID は 128 文字である必要がありますまたはそれ以下。The user ID must be 128 characters or less.
User InstanceUser Instance 'false''false' 既定の SQL Server Express インスタンスから呼び出し元のアカウントで実行されているランタイムが開始したインスタンスへの接続をリダイレクトするかどうかを示す値。A value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.
Workstation IDWorkstation ID

または-or-

WSIDWSID
ローカル コンピューターの名前The local computer name SQL Server に接続するワークステーションの名前。The name of the workstation connecting to SQL Server.

ID は 128 文字である必要がありますまたはそれ以下。The ID must be 128 characters or less.

次の一覧には、接続プール内の値の有効な名前が含まれています、ConnectionStringします。The following list contains the valid names for connection pooling values within the ConnectionString. 詳しくは、「SQL Server の接続プール (ADO.NET)」をご覧ください。For more information, see SQL Server Connection Pooling (ADO.NET).

  • 接続の有効期間 (または Load Balance Timeout)Connection Lifetime (or Load Balance Timeout)

  • EnlistEnlist

  • Max Pool SizeMax Pool Size

  • Min Pool SizeMin Pool Size

  • PoolingPooling

キーワードまたは接続プールをブール値を必要とする値を設定するときに 'yes' 'true' と 'false' ではなく ' no' の代わりに使用できます。When you are setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. 整数値は文字列として表されます。Integer values are represented as strings.

注意

.NET Framework Data Provider for SQL Server では、独自のプロトコルを使用して SQL Server と通信します。The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. そのため、これはできません ODBC データ ソース名 (DSN) の使用 ODBC レイヤーを追加しないため、SQL Server に接続するとき。Therefore, it does not support the use of an ODBC data source name (DSN) when connecting to SQL Server because it does not add an ODBC layer.

注意

ユニバーサル データ リンク (UDL) ファイルは、.NET Framework Data Provider for SQL Server のサポートされていません。Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

注意事項

このリリースでは、アプリケーションが注意を使用する必要があります (たとえば、ダイアログ ボックスでは、および接続文字列に追加することから、ユーザー ID とパスワード情報を取得するときなど) のユーザー入力に基づいて接続文字列を構築するときにします。In this release, the application should use caution when constructing a connection string based on user input (for example when retrieving user ID and password information from a dialog box, and appending it to the connection string). アプリケーションは、ユーザーがこれらの値で追加の接続文字列パラメーターを埋め込むことはできませんを確認してください (などとしてパスワードを入力する"なデータベースができない"別のデータベースに接続するために)。The application should make sure that a user cannot embed additional connection string parameters in these values (for example, entering a password as "validpassword;database=somedb" in an attempt to attach to a different database). ユーザー入力に基づいて接続文字列を作成する必要がある場合は、新しい使用SqlConnectionStringBuilderが接続文字列を検証し、この問題を解決するのに役立ちます。If you need to construct connection strings based on user input, use the new SqlConnectionStringBuilder, which validates the connection string and helps to eliminate this problem. 参照してください接続文字列ビルダー詳細についてはします。See Connection String Builders for more information.

適用対象

こちらもご覧ください