SqlConnectionStringBuilder.AttachDBFilename Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Nilai AttachDBFilename
properti , atau String.Empty
jika tidak ada nilai yang disediakan.
Pengecualian
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.