SqlConnectionStringBuilder.AttachDBFilename Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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

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 hodnotu 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 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);
        }
    }
}

Poznámky

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

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

Pokud je v připojovacím řetězci zadána hodnota klíče AttachDBFileName, databáze se připojí a stane se výchozí databází pro připojení.

Pokud tento klíč není zadán a databáze byla dříve připojena, databáze nebude znovu připojena. Dříve připojená databáze se použije jako výchozí databáze pro připojení.

Pokud je tento klíč zadán společně s klíčem AttachDBFileName, použije se jako alias hodnota tohoto klíče. Pokud se však název již používá v jiné připojené databázi, připojení se nezdaří.

Cesta může být absolutní nebo relativní pomocí řetězce nahrazení DataDirectory. Pokud se používá DataDirectory, musí soubor databáze existovat v podadresáři adresáře, na který odkazuje náhradní řetězec. Poznámka: Názvy cest vzdáleného serveru, HTTP a UNC se nepodporují.

Název databáze musí být zadán klíčovým slovem "database" (nebo jedním z jeho aliasů), jak je uvedeno v následujícím příkladu:

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

Chyba se vygeneruje, 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". V takovém případě odeberte soubor protokolu. Po připojení databáze se na základě fyzické cesty automaticky vygeneruje nový soubor protokolu.

Viz také

• Práce s připojovacími řetězci
• Přehled ovladače SqlClient