Sdílet prostřednictvím

SqlConnectionStringBuilder.AttachDBFilename Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Získá nebo nastaví řetězec, který obsahuje název primárního datového souboru. To zahrnuje úplný název cesty k připojitelné databázi.

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

Hodnota vlastnosti

String

Hodnota AttachDBFilename vlastnosti nebo String.Empty pokud nebyla zadána žádná hodnota.

Výjimky

ArgumentNullException

Pokud chcete nastavit hodnotu na null, použijte Value.

Příklady

Následující příklad vytvoří novou SqlConnectionStringBuilder instanci a nastaví AttachDBFilename vlastnost za účelem zadání názvu připojeného datového souboru.

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

Poznámky

Tato vlastnost odpovídá klíčům AttachDBFilename, extended properties a initial file name v rámci připojovací řetězec.

AttachDBFilename je podporován pouze pro primární datové soubory s příponou .mdf.

Pokud soubor protokolu existuje ve stejném adresáři jako datový soubor a při připojování primárního datového souboru se použije klíčové slovo "database", vygeneruje se chyba. V takovém případě odeberte soubor protokolu. Po připojení databáze se na základě fyzické cesty automaticky vygeneruje nový soubor protokolu.

Platí pro

Viz také