SqlConnectionStringBuilder 构造函数
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
初始化 SqlConnectionStringBuilder 类的新实例。
重载
SqlConnectionStringBuilder() |
初始化 SqlConnectionStringBuilder 类的新实例。 |
SqlConnectionStringBuilder(String) |
初始化 SqlConnectionStringBuilder 类的新实例。 所提供的连接字符串为实例的内部连接信息提供数据。 |
SqlConnectionStringBuilder()
初始化 SqlConnectionStringBuilder 类的新实例。
public:
SqlConnectionStringBuilder();
public SqlConnectionStringBuilder ();
Public Sub New ()
另请参阅
适用于
SqlConnectionStringBuilder(String)
初始化 SqlConnectionStringBuilder 类的新实例。 所提供的连接字符串为实例的内部连接信息提供数据。
public:
SqlConnectionStringBuilder(System::String ^ connectionString);
public SqlConnectionStringBuilder (string connectionString);
new System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.Data.SqlClient.SqlConnectionStringBuilder
Public Sub New (connectionString As String)
参数
- connectionString
- String
对象内部连接信息的基础。 分析为名称/值对。 无效的键名会引发 KeyNotFoundException。
例外
连接字符串中包含无效的键名。
连接字符串中包含无效的值(具体而言,需要使用布尔值或数值,但字符串中并未提供)。
所提供的 connectionString
无效。
示例
以下示例在 SqlConnectionStringBuilder 对象的构造函数中提供一个简单的 SQL Server 连接字符串,然后循环访问该对象中的所有键/值对。 请注意,该集合提供每一项的默认值。 另请注意,SqlConnectionStringBuilder 类会转换已知键的同义词,使其与已知名称一致。
注意
该示例包括一个密码以演示 SqlConnectionStringBuilder 如何使用连接字符串。 在您的应用程序中,建议使用 Windows 身份验证。 如果必须使用密码,请不要在你的应用程序中包括硬编码的密码。
using System.Data.SqlClient;
class Program
{
static void Main()
{
try
{
string connectString =
"Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
Console.WriteLine("Original: " + connectString);
SqlConnectionStringBuilder builder =
new SqlConnectionStringBuilder(connectString);
Console.WriteLine("Modified: " + builder.ConnectionString);
foreach (string key in builder.Keys)
Console.WriteLine(key + "=" + builder[key].ToString());
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
catch (System.Collections.Generic.KeyNotFoundException ex)
{
Console.WriteLine("KeyNotFoundException: " + ex.Message);
}
catch (System.FormatException ex)
{
Console.WriteLine("Format exception: " + ex.Message);
}
}
}
Imports System.Data.SqlClient
Module Module1
Sub Main()
Try
Dim connectString As String = _
"Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
Console.WriteLine("Original: " & connectString)
Dim builder As New SqlConnectionStringBuilder(connectString)
Console.WriteLine("Modified: " & builder.ConnectionString)
For Each key As String In builder.Keys
Console.WriteLine(key & "=" & builder.Item(key).ToString)
Next
Console.WriteLine("Press any key to finish.")
Console.ReadLine()
Catch ex As System.Collections.Generic.KeyNotFoundException
Console.WriteLine("KeyNotFoundException: " & ex.Message)
Catch ex As System.FormatException
Console.WriteLine("Format exception: " & ex.Message)
End Try
End Sub
End Module
注解
SqlConnectionStringBuilder 类提供键/值对的固定内部集合。 即使您只提供构造函数中可能的连接字符串值的一个小子集,该对象也会始终提供每个键/值对的默认值。
ConnectionString
检索对象的 属性时,字符串仅包含值不是项的默认值的键/值对。
另请参阅
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈