SqlConnectionStringBuilder.AttachDBFilename Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur string yang berisi nama file data utama. Ini termasuk nama jalur lengkap database yang dapat dilampirkan.

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

public string AttachDBFilename { get; set; }

member this.AttachDBFilename : string with get, set

Public Property AttachDBFilename As String

Nilai Properti

String

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

Pengecualian

ArgumentNullException

Untuk mengatur nilai ke null, gunakan Value.

Contoh

Contoh berikut membuat instans baru SqlConnectionStringBuilder , dan mengatur AttachDBFilename properti untuk menentukan nama file data terlampir.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("AttachDBFileName={0}", builder.AttachDBFilename);

            builder.AttachDBFilename = @"C:\MyDatabase.mdf";
            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Keterangan

Properti ini sesuai dengan kunci "AttachDBFilename", "extended properties", dan "initial file name" dalam string koneksi.

AttachDBFilename hanya didukung untuk file data utama dengan ekstensi .mdf.

Jika nilai kunci AttachDBFileName ditentukan dalam string koneksi, database dilampirkan dan menjadi database default untuk koneksi.

Jika kunci ini tidak ditentukan dan jika database sebelumnya dilampirkan, database tidak akan dipasang kembali. Database yang dilampirkan sebelumnya akan digunakan sebagai database default untuk koneksi.

Jika kunci ini ditentukan bersama dengan kunci AttachDBFileName, nilai kunci ini akan digunakan sebagai alias. Namun, jika nama sudah digunakan dalam database terlampir lain, koneksi akan gagal.

Jalur mungkin absolut atau relatif dengan menggunakan string substitusi DataDirectory. Jika DataDirectory digunakan, file database harus ada dalam subdirektori direktori yang diarahkan oleh string substitusi. Catatan: Nama jalur server jarak jauh, HTTP, dan UNC tidak didukung.

Nama database harus ditentukan dengan kata kunci 'database' (atau salah satu aliasnya) seperti dalam hal berikut:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Kesalahan akan dihasilkan jika file log ada di direktori yang sama dengan file data dan kata kunci 'database' digunakan saat melampirkan file data utama. Dalam hal ini, hapus file log. Setelah database dilampirkan, file log baru akan dibuat secara otomatis berdasarkan jalur fisik.

Lihat juga

• Bekerja dengan String Koneksi
• Gambaran umum driver SqlClient