SqlConnectionStringBuilder.DataSource Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur nama atau alamat jaringan instans SQL Server untuk disambungkan.

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

Nilai Properti

String

Nilai DataSource properti , atau String.Empty jika tidak ada yang disediakan.

Pengecualian

ArgumentNullException

Untuk mengatur nilai ke null, gunakan Value.

Contoh

Contoh berikut menunjukkan bahwa SqlConnectionStringBuilder kelas mengonversi sinonim untuk kunci string koneksi "Sumber Data" menjadi kunci terkenal:

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

Keterangan

Properti ini sesuai dengan kunci "Sumber Data", "server", "alamat", "addr", dan "alamat jaringan" dalam string koneksi. Terlepas dari nilai mana yang telah disediakan dalam string koneksi yang disediakan, string koneksi yang dibuat oleh SqlConnectionStringBuilder akan menggunakan kunci "Sumber Data" yang terkenal.

Nomor port dapat ditentukan setelah nama server: server=tcp:servername, portnumber.

Saat menentukan instans lokal, selalu gunakan (lokal). Untuk memaksa protokol, tambahkan salah satu awalan berikut:np:(local), tcp:(local), lpc:(local).

Anda juga dapat menyambungkan ke database LocalDB sebagai berikut: server=(localdb)\\myInstance. Untuk informasi selengkapnya tentang LocalDB, lihat Dukungan SqlClient untuk LocalDB. Sumber Data harus menggunakan format TCP atau format Named Pipes. Format TCP adalah sebagai berikut:

• tcp:<nama> host\<nama instans>
• tcp:<nama> host,nomor< port TCP/IP>

Format TCP harus dimulai dengan awalan "tcp:" dan diikuti oleh instans database, seperti yang ditentukan oleh nama host dan nama instans. Format ini tidak berlaku saat menyambungkan ke database Azure SQL. TCP secara otomatis dipilih untuk koneksi ke Azure SQL Database ketika tidak ada protokol yang ditentukan.

Nama host HARUS ditentukan dengan salah satu cara berikut:

• NetBIOSName
• IPv4Address
• IPv6Address

Nama instans digunakan untuk mengatasi nomor port TCP/IP tertentu tempat instans database dihosting. Atau, menentukan nomor port TCP/IP secara langsung juga diizinkan. Jika nama instans dan nomor port tidak ada, instans database default akan digunakan.

Format Named Pipes adalah sebagai berikut:

• np:\host< name>\pipe\<pipe name>

Format Named Pipes HARUS dimulai dengan awalan "np:" dan diikuti dengan nama pipa bernama.

Nama host HARUS ditentukan dengan salah satu cara berikut:

• NetBIOSName
• IPv4Address
• IPv6Address

Nama pipa digunakan untuk mengidentifikasi instans database yang akan disambungkan oleh aplikasi .NET.

Jika nilai kunci Jaringan ditentukan, awalan "tcp:" dan "np:" tidak boleh ditentukan. Catatan: Anda dapat memaksa penggunaan TCP alih-alih memori bersama, baik dengan mengawali tcp: ke nama server dalam string koneksi, atau dengan menggunakan localhost.