DB2Connection.ConnectionString 属性

名称空间：

IBM.Data.DB2

组合件：

IBM.Data.DB2（在 IBM.Data.DB2.dll 中）

语法

[Visual Basic]
Public Property ConnectionString As String  Implements _
   IDbConnection.ConnectionString
[C#]
public string ConnectionString {get; set;}
[C++]
public: __property String* get_ConnectionString();
public: __property void set_ConnectionString(String*);
[JScript]
public function get ConnectionString() : String;
public function set ConnectionString(String);

实现：

IDbConnection.ConnectionString

属性值

连接字符串，它包括建立初始连接所需的设置（例如，数据库名称）。缺省值为空字符串（""）。最大长度为 1024 个字符。

注释

可以使用 ConnectionString 属性来连接至任何受支持的数据服务器。仅当连接关闭时您才能设置 ConnectionString 属性。

以下表描述了支持的关键字。

可在字符串中指定的许多设置都具有相应的只读属性，例如，DATABASE 与 Database 属性相对应。设置连接字符串时，将更新所有这些只读属性（除非检测到了错误）。在检测到错误的情况下，将不更新任何属性。DB2Connection 属性（例如 Database）仅返回缺省设置或者为 ConnectionString 属性指定的那些设置。

在您设置连接字符串时，将对其进行验证。

在已关闭的连接上重置 ConnectionString 属性时将重置包括密码在内的所有连接字符串值及相关属性。

示例

[Visual Basic, C#] 以下示例将创建 DB2Connection 并在连接字符串中设置它的一些属性：

[Visual Basic]
Public Sub CreateDB2Connection()
    Dim myConnString As String = _
       "DATABASE=SAMPLE;"
    Dim myConnection As New DB2Connection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
       + ControlChars.Cr + "Database: " + myConnection.Database.ToString())
    myConnection.Close()
End Sub

[C#]
public void CreateDB2Connection()
{
   string myConnString = "DATABASE=SAMPLE;";
   DB2Connection myConnection = new DB2Connection(myConnString);
   myConnection.Open();
   MessageBox.Show("ServerVersion: " + myConnection.ServerVersion
      + "\nDatabase: " + myConnection.Database.ToString());
   myConnection.Close();
}