SqlConnectionStringBuilder.AttachDBFilename Özellik

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

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 adını belirtmek için özelliğini ayarlar AttachDBFilename .

using System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
             "Server=(local);" & _
             "Integrated Security=True"
            Dim builder As 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 connection As New SqlConnection(builder.ConnectionString)
                connection.Open()
                ' Now use the open connection.
                Console.WriteLine("Database = " & connection.Database)
            End Using

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

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Sub
End Module

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.

Veri dosyasıyla aynı dizinde bir günlük dosyası varsa ve birincil veri dosyası eklenirken 'database' anahtar sözcüğü kullanılıyorsa 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.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış