.Net 连接字符串的解释

Posted 2020-07-30 河边杨柳树

https://msdn.microsoft.com/zh-cn/library/cc716756.aspx

 

连接字符串参数

连接字符串的格式是使用分号分隔的键/值参数对列表：

keyword1=value; keyword2=value;

每个关键字和它的值之间用等号 (=) 连接。 关键字不区分大小写，并将忽略键/值对之间的空格。 不过，根据数据源的不同，值可能是区分大小写的。 任何包含分号、单引号或双引号的值必须用双引号引起来。 下表列出了 ConnectionString 中的关键字值的有效名称。

关键字	描述
Provider	此关键字在未指定 Name 关键字时是必需的。 提供程序名称，用于检索基础提供程序的 DbProviderFactory 对象。 该值为常量。 如果实体连接字符串中未包含 Name 关键字，则需要一个非空 Provider 关键字值。 此关键字与 Name 关键字互斥。
Provider Connection String	可选。 指定要传递给基础数据源的提供程序特定的连接字符串。 此连接字符串用数据提供程序的有效关键字/值对表示。 如果 Provider Connection String 无效，则当数据源计算此字符串时，将导致运行时错误。 此关键字与 Name 关键字互斥。 Provider Connection String 的值必须用引号引起来。 下面是一个示例： Provider Connection String ="Server=serverName; User ID = userID"; 以下示例将无效： Provider Connection String =Server=serverName; User ID = userID
Metadata	此关键字在未指定 Name 关键字时是必需的。 一个由竖线分隔的目录、文件和资源位置的列表，供查找元数据和映射信息使用。 下面是一个示例： Metadata= c:\model | c:\model\sql\mapping.msl; 竖线分隔符两侧的空格将被忽略。 此关键字与 Name 关键字互斥。
Name	应用程序可以选择在应用程序配置文件中指定连接名称，以用于提供所需的关键字/值连接字符串值。 在此情况下，无法在连接字符串中直接提供这些值。 配置文件中不允许出现 Name 关键字。 如果连接字符串中未包含 Name 关键字，则需要一个非空的 Provider 关键字值。 此关键字与所有其他连接字符串关键字互斥。