OdbcConnection.ConnectionString OdbcConnection.ConnectionString OdbcConnection.ConnectionString OdbcConnection.ConnectionString Property

定義

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

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

プロパティ値

最初の接続を確立するために必要なデータ ソース名などの設定を含む ODBC ドライバー接続文字列。The ODBC driver connection string that includes settings, such as the data source name, needed to establish the initial connection. 既定値は、空の文字列 ("") です。The default value is an empty string (""). 最大長は 1024 文字です。The maximum length is 1024 characters.

注釈

ConnectionStringプロパティは ODBC 接続文字列の形式をできるだけ一致するように設計されています。The ConnectionString property is designed to match ODBC connection string format as closely as possible. ConnectionString設定できる場合にのみ接続を終了すると、設定されているとすぐに渡される、変更せずに、ドライバー マネージャーを基になるドライバー。The ConnectionString can be set only when the connection is closed, and as soon as it is set it is passed, unchanged, to the Driver Manager and the underlying driver. そのため、構文をConnectionStringドライバー マネージャーを正確に一致する必要があり、ドライバーのサポートを基になります。Therefore, the syntax for the ConnectionString must exactly match what the Driver Manager and underlying driver support.

使用することができます、ConnectionStringプロパティをさまざまなデータ ソースに接続します。You can use the ConnectionString property to connect to a variety of data sources. これには、ODBC データ ソース名 (DSN) が含まれます。This includes an ODBC data source name (DSN). 次の例では、いくつかの可能な接続文字列を示します。The following example illustrates several possible connection strings.

"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"  

"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"  

"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"  

"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"  

"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"  

"DSN=dsnname"  

注意

.NET Framework Data Provider for ODBC がサポートしていません、Persist Security Info他の .NET Framework データ プロバイダーでサポートされているキーワード。The .NET Framework Data Provider for ODBC does not support the Persist Security Info keyword that is supported by other .NET Framework data providers. ただし、ConnectionStringプロパティの動作としてPersist Security Infoに設定されたfalseします。However, the ConnectionString property behaves as if Persist Security Info were set to false. つまりからパスワードを取得することはできません、ConnectionStringプロパティ、接続が開かれている場合。This means that you cannot retrieve the password from the ConnectionString property if the connection has been opened. ときに、ConnectionStringプロパティを読み取ったり、OdbcConnectionが開かれているオブジェクトの場合は、マイナス、パスワード、接続文字列が返されます。When the ConnectionString property is read from an OdbcConnection object that has been opened, the connection string is returned minus the password. この動作を変更することはできません。そのため、アプリケーションは、パスワードを必要とする場合は別に保管呼び出す前にOpenします。You cannot change this behavior; therefore, if the application requires the password, store it separately before calling Open.

対応する読み取り専用プロパティを持つ文字列で指定された設定の多く (たとえば、Server=(local)に対応する、DataSourceプロパティ)。Many of the settings specified in the string have corresponding read-only properties (for example, Server=(local), which corresponds to the DataSource property). これらのプロパティは、エラーが検出された場合を除く、接続が開かれた後に更新されます。These properties are updated after the connection is opened, except when an error is detected. ここで、プロパティのいずれも更新されます。In this case, none of the properties are updated. OdbcConnection プロパティ (などDatabase) 既定の設定またはで指定されたこれらの設定のみを返す、ConnectionStringします。OdbcConnection properties (such as Database) return only default settings or those settings specified in the ConnectionString.

Microsoft .NET Framework version 1.0 でアプリケーションを呼び出すまで、接続文字列の検証は行われません、Openメソッド。In the Microsoft .NET Framework version 1.0, validation of the connection string does not occur until an application calls the Open method. 接続文字列を検証する基になる ODBC ドライバーの役目です。It is the responsibility of the underlying ODBC driver to validate the connection string. 接続文字列に無効またはサポートされていないプロパティが含まれている場合、ドライバーが生じる可能性がある、OdbcException実行時にします。If the connection string contains invalid or unsupported properties, the driver may raise an OdbcException at run time.

ただし、.NET Framework version 1.1 以降のバージョンで、接続文字列のいくつかの基本的な検証が発生したを設定するとすぐに、ConnectionStringプロパティ。However, in the .NET Framework version 1.1 and later versions, some basic validation of the connection string occurs as soon as you set the ConnectionString property. データ プロバイダーが接続文字列を満たしていることを確認、その時点で、"キーワード値 =;..."の形式は検証されませんキーワードまたは値が有効かどうか。At that time, the data provider verifies that the connection string meets the "keyword=value;..." format, but it does not verify whether keywords or values are valid. アプリケーションを呼び出すときに、基になる ODBC ドライバーによって、残りの検証が実行される、Openメソッド。The remaining verification is performed by the underlying ODBC driver when the application calls the Open method.

ODBC 接続文字列では、次の構文があります。An ODBC connection string has the following syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string  
empty-string ::=  
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]  
attribute-keyword ::= DSN | UID | PWD  
 | driver-defined-attribute-keyword  
attribute-value ::= character-string  
driver-defined-attribute-keyword ::= identifier  

場所character-string0 個以上の文字。identifierが 1 つ以上の文字。attribute-keywordは大文字と小文字の区別はありませんattribute-value大文字と小文字を区別することができ、DSN キーワードの値は空白ののみで構成されていません。where character-string has zero or more characters; identifier has one or more characters; attribute-keyword is not case sensitive; attribute-value can be case sensitive; and the value of the DSN keyword does not consist only of blanks.

接続文字列と初期化ファイルの文法のためのキーワードと属性値避ける必要があります文字が含まれている{}()、;?* =! @ 中かっこで囲まれていません。Because of connection string and initialization file grammar, keywords and attribute values should be avoided that contain the characters []{}(),;?*=!@ not enclosed with braces. DSN キーワードの値は空白ののみで構成されていることはできませんし、先頭の空白を含めることはできません。The value of the DSN keyword cannot consist only of blanks and should not contain leading blanks. によりシステム情報の文章では、キーワード、およびデータ ソース名が円記号を含めることはできません (\) 文字。Because of the grammar of the system information, keywords and data source names cannot contain the backslash (\) character.

アプリケーションの属性には、セミコロン (;) が含まれていない場合は、Driver キーワードの後に属性値を囲む中かっこを追加する場合、中かっこは必須でありません。Applications do not have to add braces around the attribute value after the Driver keyword unless the attribute contains a semicolon (;), in which case the braces are required. ドライバーが受信した属性の値には、中かっこが含まれている場合、ドライバーは削除せず、返される接続文字列の一部である必要があります。If the attribute value that the driver receives includes braces, the driver should not remove them but they should be part of the returned connection string.

中かっこで囲まれた DSN または接続文字列値 ({}) 文字のいずれかを格納している{}()、;?* =! @ はそのままドライバーに渡される、します。A DSN or connection string value enclosed with braces ({}) that contains any of the characters []{}(),;?*=!@ is passed intact to the driver. ただし、キーワードでこれらの文字を使用すると、ドライバー マネージャーが、Dsn ファイルを使用するときにエラーが返されますが、通常の接続文字列用のドライバーに接続文字列を渡します。However, when you use these characters in a keyword, the Driver Manager returns an error when you work with file DSNs, but passes the connection string to the driver for regular connection strings. キーワードの値に埋め込まれた中かっこを使用しないでください。Avoid using embedded braces in a keyword value.

接続文字列は、任意の数のドライバー定義のキーワードを含めることができます。The connection string may include any number of driver-defined keywords. DRIVER キーワードは、システムからの情報を使用しないので、ドライバーは、ドライバーは接続文字列情報のみを使用してデータ ソースに接続できるように十分なキーワードを定義する必要があります。Because the DRIVER keyword does not use information from the system, the driver must define enough keywords so that a driver can connect to a data source using only the information in the connection string. ドライバーでは、どのキーワードはデータ ソースに接続するために必要なものを定義します。The driver defines which keywords are required to connect to the data source.

一切のキーワード、接続文字列で、反復的である場合、値は選択されている保証はありません。If any keywords are repeated in the connection string, there is no guarantee which value will be selected.

注意

ODBC ドライバーでは、1024 文字より長く接続文字列をサポートする場合は、最大長の制限を超えるデータ ソース名 (DSN) を使用できます。If an ODBC driver supports connection strings longer than 1024 characters, you can use a data source name (DSN) to exceed the maximum length limitation.

適用対象

こちらもご覧ください