SqlConnectionStringBuilder.AttachDBFilename Eigenschap

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Hiermee wordt een tekenreeks opgehaald of ingesteld die de naam van het primaire gegevensbestand bevat. Dit omvat de volledige padnaam van een koppelbare 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

Waarde van eigenschap

String

De waarde van de AttachDBFilename eigenschap of String.Empty als er geen waarde is opgegeven.

Uitzonderingen

ArgumentNullException

Als u de waarde wilt instellen op null, gebruikt u Value.

Voorbeelden

In het volgende voorbeeld wordt een nieuw SqlConnectionStringBuilder exemplaar gemaakt en wordt de AttachDBFilename eigenschap ingesteld om de naam van een bijgevoegd gegevensbestand op te geven.

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

Opmerkingen

Deze eigenschap komt overeen met de sleutels 'AttachDBFilename', 'extended properties' en 'initial file name' in de verbindingsreeks.

AttachDBFilename wordt alleen ondersteund voor primaire gegevensbestanden met een .mdf-extensie.

Er wordt een fout gegenereerd als er een logboekbestand bestaat in dezelfde map als het gegevensbestand en het trefwoord 'database' wordt gebruikt bij het koppelen van het primaire gegevensbestand. Verwijder in dit geval het logboekbestand. Zodra de database is gekoppeld, wordt er automatisch een nieuw logboekbestand gegenereerd op basis van het fysieke pad.

Van toepassing op

Zie ook