SqlConnectionStringBuilder.AttachDBFilename Eigenschaft

Definition

Ruft eine Zeichenfolge ab, die den Namen der Primärdatendatei enthält, oder legt diese Zeichenfolge fest.Gets or sets a string that contains the name of the primary data file. Dazu gehört der vollständige Pfadname einer anfügbaren Datenbank.This includes the full path name of an attachable database.

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

Der Wert der AttachDBFilename-Eigenschaft oder String.Empty, wenn kein Wert angegeben wurde.The value of the AttachDBFilename property, or String.Empty if no value has been supplied.

Ausnahmen

Verwenden Sie Value, um den Wert auf NULL festzulegen.To set the value to null, use Value.

Beispiele

Im folgenden Beispiel wird eine neue Instanz SqlConnectionStringBuilder erstellt und die AttachDBFilename-Eigenschaft festgelegt, um den Namen einer angefügten Datendatei anzugeben.The following example creates a new SqlConnectionStringBuilder instance, and sets the AttachDBFilename property in order to specify the name of an attached data file.

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 auch den Schlüsseln "AttachDBFilename", "extended properties" und "initial file name" in der Verbindungszeichenfolge.This property corresponds to the "AttachDBFilename", "extended properties", and "initial file name" keys within the connection string.

AttachDBFilename wird nur für primäre Datendateien mit der Erweiterung MDF unterstützt.AttachDBFilename is only supported for primary data files with an .mdf extension.

Ein Fehler wird generiert, wenn eine Protokolldatei im gleichen Verzeichnis wie die Datendatei enthalten ist und beim Anfügen der primären Datendatei das Schlüsselwort "database" verwendet wird.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. Entfernen Sie in diesem Fall die Protokolldatei.In this case, remove the log file. Sobald die Datenbank angefügt wird, wird automatisch auf Grundlage des physischen Pfads eine neue Protokolldatei generiert.Once the database is attached, a new log file will be automatically generated based on the physical path.

Gilt für:

Siehe auch