SqlConnectionStringBuilder.DataSource 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得或設定要連接之 SQL Server 執行個體的名稱或網路位址。

public:
 property System::String ^ DataSource { System::String ^ get(); void set(System::String ^ value); };

public string DataSource { get; set; }

member this.DataSource : string with get, set

Public Property DataSource As String

屬性值

String

DataSource 屬性的值，如未提供任何值，則為 String.Empty。

例外狀況

ArgumentNullException

若要將值設定為 null，請使用 Value。

範例

下列範例示範 SqlConnectionStringBuilder 類別如何將 "Data Source" 連接字串索引鍵的同義資料表轉換成已知的索引鍵：

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Network Address=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks");

        // Display the connection string, which should now 
        // contain the "Data Source" key, as opposed to the 
        // supplied "Network Address".
        Console.WriteLine(builder.ConnectionString);

        // Retrieve the DataSource property.
        Console.WriteLine("DataSource = " + builder.DataSource);

        Console.WriteLine("Press any key to continue.");
        Console.ReadLine();
    }
}

備註

這個屬性會對應至連接字串中的 "Data Source"、"server"、"address"、"addr" 和 "network address" 索引鍵。 無論在提供的連接字串中提供哪些值，所 SqlConnectionStringBuilder 建立的連接字串都會使用已知的「資料來源」索引鍵。

您可以在伺服器名稱之後指定埠號碼： server=tcp:servername, portnumber 。

指定本機實例時，一律使用本機 () 。 若要強制通訊協定，請新增下列其中一個前置詞： np:(local), tcp:(local), lpc:(local) 。

您也可以連線到 LocalDB 資料庫，如下所示： server=(localdb)\\myInstance 。 如需 LocalDB 的詳細資訊，請參閱 LocalDB 的 SqlClient 支援。 資料來源 必須使用 TCP 格式或具名管道格式。 TCP 格式如下所示：

• tcp： < host name\ < instance name >>
• tcp： < 主機名稱 > ， < TCP/IP 埠號碼>

TCP 格式的開頭必須是前置詞 「tcp：」，後面接著資料庫實例，如主機名稱和實例名稱所指定。 連接到 Azure SQL Database 時，不適用此格式。 未指定通訊協定時，會自動選取 TCP 以連線至 Azure SQL Database。

主機名稱必須以下列其中一種方式指定：

• NetBIOSName
• IPv4Address
• IPv6Address

實例名稱是用來解析為裝載資料庫實例的特定 TCP/IP 埠號碼。 或者，也允許直接指定 TCP/IP 埠號碼。 如果實例名稱和埠號碼不存在，則會使用預設的資料庫實例。

具名管道格式如下所示：

• np：\\ < host name > \pipe\pipe 名稱 <>

具名管道格式必須以前置詞 「np：」 開頭，後面接著具名管道名稱。

主機名稱必須以下列其中一種方式指定：

• NetBIOSName
• IPv4Address
• IPv6Address

管道名稱是用來識別 .NET 應用程式將連接的資料庫實例。

如果指定 網路 金鑰的值，則不應該指定前置詞 「tcp：」 和 「np：」。 注意： 您可以藉由在連接字串中的伺服器名稱前面加上 tcp， 或使用 localhost，強制使用 TCP 而非共用記憶體。