SqlConnectionStringBuilder.AttachDBFilename Właściwość

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

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

Wyjątki

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.

Dotyczy

Zobacz też

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