SqlConnectionStringBuilder.AttachDBFilename Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Pobiera lub ustawia ciąg zawierający nazwę podstawowego pliku danych. Obejmuje to pełną nazwę ścieżki dołączanej bazy danych.

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

Wartość właściwości

String

Wartość AttachDBFilename właściwości lub String.Empty jeśli nie podano żadnej wartości.

Wyjątki

ArgumentNullException

Aby ustawić wartość null, użyj polecenia Value.

Przykłady

Poniższy przykład tworzy nowe SqlConnectionStringBuilder wystąpienie i ustawia AttachDBFilename właściwość w celu określenia nazwy dołączonego pliku danych.

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

Uwagi

Ta właściwość odpowiada kluczom "AttachDBFilename", "extended properties" i "initial file name" w parametrach połączenia.

AttachDBFilename Program jest obsługiwany tylko w przypadku podstawowych plików danych z rozszerzeniem mdf.

Jeśli wartość klucza AttachDBFileName jest określona w parametrach połączenia, baza danych jest dołączona i staje się domyślną bazą danych dla połączenia.

Jeśli ten klucz nie zostanie określony i baza danych została wcześniej dołączona, baza danych nie zostanie ponownie dołączona. Wcześniej dołączona baza danych będzie używana jako domyślna baza danych dla połączenia.

Jeśli ten klucz zostanie określony razem z kluczem AttachDBFileName, wartość tego klucza zostanie użyta jako alias. Jeśli jednak nazwa jest już używana w innej dołączonej bazie danych, połączenie zakończy się niepowodzeniem.

Ścieżka może być bezwzględna lub względna przy użyciu ciągu podstawienia DataDirectory. Jeśli jest używany element DataDirectory, plik bazy danych musi istnieć w podkatalogu katalogu wskazywanego przez ciąg podstawienia. Uwaga: Nazwy ścieżek SERWERA zdalnego, HTTP i UNC nie są obsługiwane.

Nazwa bazy danych musi być określona za pomocą słowa kluczowego "database" (lub jednego z jego aliasów), jak pokazano poniżej:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Błąd zostanie wygenerowany, jeśli plik dziennika istnieje w tym samym katalogu co plik danych, a słowo kluczowe "database" jest używane podczas dołączania pliku danych podstawowych. W takim przypadku usuń plik dziennika. Po dołączeniu bazy danych nowy plik dziennika zostanie automatycznie wygenerowany na podstawie ścieżki fizycznej.

Zobacz też

• Praca z parametrami połączenia
• Omówienie sterownika SqlClient