SqlConnectionStringBuilder.InitialCatalog Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur nama database yang terkait dengan koneksi.

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

public string InitialCatalog { get; set; }

member this.InitialCatalog : string with get, set

Public Property InitialCatalog As String

Nilai Properti

String

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

Pengecualian

ArgumentNullException

Untuk mengatur nilai ke null, gunakan Value.

Contoh

Contoh berikut membuat string koneksi sederhana lalu menggunakan SqlConnectionStringBuilder kelas untuk menambahkan nama database ke string koneksi. Kode menampilkan konten InitialCatalog properti, hanya untuk memverifikasi bahwa kelas dapat mengonversi dari sinonim ("Database") ke nilai properti yang sesuai.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Data Source=(local);" +
                "Integrated Security=true";

            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Normally, you could simply set the InitialCatalog
            // property of the SqlConnectionStringBuilder object. This
            // example uses the default Item property (the C# indexer)
            // and the "Database" string, simply to demonstrate that
            // setting the value in this way results in the same
            // connection string:
            builder["Database"] = "AdventureWorks";
            Console.WriteLine("builder.InitialCatalog = "
                + builder.InitialCatalog);
            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection connection =
                new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

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

Keterangan

Properti ini sesuai dengan kunci "Katalog Awal" dan "database" dalam string koneksi.

Nama database bisa 128 karakter atau kurang.