语法

public override string ConnectionString { get; set; }

/** @property */
public String get_ConnectionString ()/** @property */
public void set_ConnectionString (String value)

public override function get ConnectionString () : Stringpublic override function set ConnectionString (value : String)

属性值

包含设置（如服务器名称等）的 Oracle 连接字符串需要建立初始连接。默认值为空字符串 ("")。

备注

只有在连接关闭时才能设置 ConnectionString 属性。

可以使用 ConnectionString 属性连接到数据库。下面的示例阐释了一个典型的连接字符串。

"Data Source=Oracle8i;Integrated Security=yes"

在字符串中指定的许多设置都具有相应的只读属性（例如，与 DataSource 属性对应的 Data Source=MyServer）。当设置连接字符串时，所有这些属性都将被更新，除非检测到错误；如果发生错误，则不更新任何属性。OracleConnection 属性只返回默认设置或者那些在 ConnectionString 中指定的设置。

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

在设置后会立即分析连接字符串。如果分析时发现语法错误，则会生成运行时异常，如 ArgumentException。只有当试图打开连接时，才会发现其他错误。

连接字符串的基本格式是一系列由分号分隔的关键字/值对。等号 (= ) 连接各个关键字及其值。若要包括含有分号、单引号字符或双引号字符的值，则该值必须用双引号括起来。如果该值同时包含分号和双引号字符，则该值可以用单引号括起来。如果该值以双引号字符开始，则还可以使用单引号。相反地，如果该值以单引号开始，则可以使用双引号。如果该值同时包含单引号和双引号字符，则用于将值括起来的引号字符每次出现时，都必须成对出现。

若要在字符串值中包括前导或尾随空格，则该值必须用单引号或双引号括起来。即使将整数、布尔值或枚举值用引号括起来，其周围的任何前导或尾随空格也将被忽略。然而，保留字符串关键字或值内的空格。如果引号字符不是值中的第一个字符或最后一个字符，则可在没有使用分隔符的连接字符串中使用单引号或双引号（例如，Data Source= my'Server 或 Data Source= my"Server）。

若要在关键字或值中包括等号 (=)，则它之前必须还有另一个等号。例如，在假设的连接字符串中，

"key==word=value"

关键字是“key=word”并且值是“value”。

如果关键字/值对中的一个特定关键字多次出现在连接字符串中，则将所列出的最后一个用于值集。

关键字不区分大小写。

下表为 ConnectionString 内的值列出了有效的名称。

下表列出了 ConnectionString 内连接池值的有效名称。

当设置需要布尔值的关键字或连接池值时，您可以使用 'yes' 代替 'true'，'no' 代替 'false'。整数值表示为字符串。

示例

下面的示例创建一个 OracleConnection，并在连接字符串中设置它的一些属性。

public void CreateOracleConnection()
{string connectionString = "Data Source=Oracle8i;Integrated Security=yes";using (OracleConnection connection = new OracleConnection(connectionString)){connection.Open();Console.WriteLine("ServerVersion: " + connection.ServerVersion+ "\nDataSource: " + connection.DataSource);}
}

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1

请参见

参考

OracleConnection 类
OracleConnection 成员
System.Data.OracleClient 命名空间