SqlConnectionStringBuilder.AttachDBFilename Eigenschaft

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Namen der primären Datendatei enthält. Dies schließt den vollständigen Pfadnamen einer anfügenden Datenbank ein.

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

Eigenschaftswert

String

Der Wert der AttachDBFilename Eigenschaft oder String.Empty wenn kein Wert angegeben wurde.

Ausnahmen

ArgumentNullException

Um den Wert auf NULL festzulegen, verwenden Sie Value.

Beispiele

Im folgenden Beispiel wird eine neue SqlConnectionStringBuilder Instanz erstellt und die AttachDBFilename Eigenschaft festgelegt, um den Namen einer angefügten Datendatei anzugeben.

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

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "AttachDBFilename", "extended properties" und "initial file name" innerhalb der Verbindungszeichenfolge.

AttachDBFilename wird nur für primäre Datendateien mit einer .mdf Erweiterung unterstützt.

Ein Fehler wird generiert, wenn eine Protokolldatei im selben Verzeichnis wie die Datendatei vorhanden ist und das Schlüsselwort "database" beim Anfügen der primären Datendatei verwendet wird. Entfernen Sie in diesem Fall die Protokolldatei. Sobald die Datenbank angefügt ist, wird basierend auf dem physischen Pfad automatisch eine neue Protokolldatei generiert.

Gilt für:

Weitere Informationen