SqlConnectionStringBuilder.AttachDBFilename Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Zestawy:: netstandard.dll, System.Data.SqlClient.dll

Pakiet:: System.Data.SqlClient v4.8.6

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Uwagi

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

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

Zostanie wygenerowany błąd, jeśli plik dziennika istnieje w tym samym katalogu co plik danych, a słowo kluczowe "baza danych" 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

Udostępnij przez