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
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.