SqlConnectionStringBuilder.AttachDBFilename Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Birincil veri dosyasının adını içeren bir dize alır veya ayarlar. Bu, eklenebilir veritabanının tam yol adını içerir.

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

Özellik Değeri

String

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

Özel durumlar

ArgumentNullException

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

Örnekler

Aşağıdaki örnek yeni SqlConnectionStringBuilder bir örnek oluşturur ve ekli veri dosyasının AttachDBFilename adını belirtmek için özelliğini ayarlar.

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

Açıklamalar

Bu özellik bağlantı dizesi içindeki "AttachDBFilename", "extended properties" ve "initial file name" anahtarlarına karşılık gelir.

AttachDBFilename yalnızca .mdf uzantısına sahip birincil veri dosyaları için desteklenir.

AttachDBFileName anahtarının değeri bağlantı dizesinde belirtilirse, veritabanı eklenir ve bağlantı için varsayılan veritabanı olur.

Bu anahtar belirtilmezse ve veritabanı daha önce eklenmişse, veritabanı yeniden bağlanmaz. Önceden eklenen veritabanı, bağlantı için varsayılan veritabanı olarak kullanılır.

Bu anahtar AttachDBFileName anahtarıyla birlikte belirtilirse, bu anahtarın değeri diğer ad olarak kullanılır. Ancak, ad başka bir ekli veritabanında zaten kullanılıyorsa bağlantı başarısız olur.

DataDirectory değiştirme dizesini kullanarak yol mutlak veya göreli olabilir. DataDirectory kullanılırsa veritabanı dosyası, değiştirme dizesi tarafından işaret edilen dizinin bir alt dizininde bulunmalıdır. Not: Uzak sunucu, HTTP ve UNC yol adları desteklenmez.

Veritabanı adı, aşağıdaki gibi 'database' (veya diğer adlarından biri) anahtar sözcüğüyle belirtilmelidir:

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

Veri dosyasıyla aynı dizinde bir günlük dosyası varsa ve birincil veri dosyası eklenirken 'database' anahtar sözcüğü kullanılırsa bir hata oluşturulur. Bu durumda günlük dosyasını kaldırın. Veritabanı eklendikten sonra, fiziksel yola göre otomatik olarak yeni bir günlük dosyası oluşturulur.

Ayrıca bkz.

• Bağlantı Dizeleriyle Çalışma
• SqlClient sürücüsüne genel bakış