Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - 编程 » SQL Anywhere 数据访问 API » SQL Anywhere .NET 2.0 API 参考 » iAnywhere.Data.SQLAnywhere 命名空间 (.NET 2.0) » SAConnection 类

 

ConnectionString 属性

提供数据库连接字符串。

语法
Visual Basic

Public Overrides Property ConnectionString As String
C#

public override string  ConnectionString { get; set; }
注释

ConnectionString 设计为尽可能与 SQL Anywhere 连接字符串的格式匹配,但有以下例外情况:Persist Security Info 值设置为 false(缺省值)时,返回的连接字符串与用户设置的 ConnectionString 去除安全性信息后的内容相同。除非将 Persist Security Info 设置为 true,否则 SQL Anywhere SQL Anywhere .NET 数据提供程序不会在返回的连接字符串中持久性地保存口令。

使用 ConnectionString 属性可以连接到多种类型的数据源。

只有关闭连接时才能设置 ConnectionString 属性。许多连接字符串值都有相应的只读属性。设置连接字符串后,将会更新所有这些属性,除非检测到错误。如果检测到错误,则不会更新任何属性。SAConnection 属性仅返回 ConnectionString 中包含的那些设置。

如果在关闭的连接上重置 ConnectionString,则所有连接字符串值和相关属性(包括口令)都会被重置。

设置该属性时会对连接字符串执行预备校验。应用程序调用 Open 方法时会完全校验连接字符串。如果连接字符串包含无效或不受支持的属性,则会产生运行时异常。

值可用单引号或双引号进行分隔。可以在连接字符串内使用单引号或双引号,但前提是使用某一种引号时须使用另一种引号作为分隔符。例如,name="value's" 或 name= 'value"s' 是允许的,而 name='value's' 或 name= ""value"" 则不允许。除非空白字符置于值或引号内,否则将被忽略。"关键字=值" 对必须以分号分隔。作为值一部分的分号必须以引号分隔。不支持转义序列,该值类型也没有实用性。名称不区分大小写。如果属性名在连接字符串中出现多次,将使用其最后一次出现时所关联的值。

基于用户输入构建连接字符串(如从窗口检索用户 ID 和口令并将其附加到连接字符串)时应该小心谨慎。应用程序不应允许用户将额外的连接字符串参数嵌入到这些值中。

连接池的缺省值为 true (pooling=true)。

示例

以下语句为名为 SQL Anywhere 11 Demo 的 ODBC 数据源设置连接字符串并打开该连接。

SAConnection conn = new SAConnection();
conn.ConnectionString = "DSN=SQL Anywhere 11 Demo";
conn.Open();
另请参见