SqlConnectionStringBuilder.DataSource Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Bağlanacak SQL Server örneğinin adını veya ağ adresini alır veya ayarlar.

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

Özellik Değeri

String

özelliğinin DataSource değeri veya String.Empty sağlanmamışsa.

Özel durumlar

ArgumentNullException

Değeri null olarak ayarlamak için kullanın Value.

Örnekler

Aşağıdaki örnek, sınıfının "Veri Kaynağı" bağlantı dizesi anahtarı için eş anlamlıları iyi bilinen anahtara dönüştürdüğünü gösterir SqlConnectionStringBuilder :

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();
    }
}

Açıklamalar

Bu özellik bağlantı dizesi içindeki "Veri Kaynağı", "sunucu", "adres", "ekleyici" ve "ağ adresi" anahtarlarına karşılık gelir. Sağlanan bağlantı dizesi içinde bu değerlerden hangilerinin sağlandığına bakılmaksızın, tarafından SqlConnectionStringBuilder oluşturulan bağlantı dizesi iyi bilinen "Veri Kaynağı" anahtarını kullanır.

Bağlantı noktası numarası sunucu adından sonra belirtilebilir: server=tcp:servername, portnumber.

Yerel bir örnek belirtirken her zaman (yerel) kullanın. Bir protokolü zorlamak için aşağıdaki ön eklerden birini ekleyin:np:(local), tcp:(local), lpc:(local)

Bir LocalDB veritabanına şu şekilde de bağlanabilirsiniz: server=(localdb)\\myInstance. LocalDB hakkında daha fazla bilgi için bkz. LocalDB için SqlClient Desteği. Veri Kaynağı TCP biçimini veya Adlandırılmış Kanallar biçimini kullanmalıdır. TCP biçimi aşağıdaki gibidir:

• tcp:<konak adı>\<örnek adı>
• tcp:<ana bilgisayar adı,TCP></IP bağlantı noktası numarası>

TCP biçimi "tcp:" ön eki ile başlamalıdır ve bir konak adı ve örnek adı tarafından belirtildiği gibi veritabanı örneği tarafından takip edilir. Bu biçim, Azure SQL Veritabanına bağlanırken geçerli değildir. Protokol belirtilmediğinde Azure SQL Veritabanı bağlantıları için TCP otomatik olarak seçilir.

Ana bilgisayar adı aşağıdaki yollardan biriyle belirtilmelidir:

• NetBIOSName
• IPv4Address
• IPv6Address

Örnek adı, bir veritabanı örneğinin barındırıldığı belirli bir TCP/IP bağlantı noktası numarasına çözümlemek için kullanılır. Alternatif olarak, doğrudan bir TCP/IP bağlantı noktası numarası belirtilmesine de izin verilir. Hem örnek adı hem de bağlantı noktası numarası yoksa, varsayılan veritabanı örneği kullanılır.

Adlandırılmış Kanallar biçimi aşağıdaki gibidir:

• np:\\<ana bilgisayar adı>\kanal\<kanal adı>

Adlandırılmış Kanallar biçimi "np:" ön eki ile başlamalıdır ve ardından adlandırılmış kanal adı eklenir.

Ana bilgisayar adı aşağıdaki yollardan biriyle belirtilmelidir:

• NetBIOSName
• IPv4Address
• IPv6Address

Kanal adı, .NET uygulamasının bağlanacağı veritabanı örneğini tanımlamak için kullanılır.

Ağ anahtarının değeri belirtilirse, "tcp:" ve "np:" ön ekleri belirtilmemelidir. Not: Tcp: ön ekini bağlantı dizesindeki sunucu adına ekleyerek veya localhost kullanarak paylaşılan bellek yerine TCP kullanımını zorlayabilirsiniz.