SqlConnectionStringBuilder.AttachDBFilename Proprietà

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

Valore della proprietà

Valore della proprietà AttachDBFilename o String.Empty se non è stato fornito alcun valore.

Eccezioni

Esempio

Nell'esempio seguente viene creata una nuova SqlConnectionStringBuilder istanza e viene impostata la AttachDBFilename proprietà per specificare il nome di un file di dati associato.

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

Commenti

Questa proprietà corrisponde alle chiavi "AttachDBFilename", "extended properties", e "initial file name" all'interno della stringa di connessione.

AttachDBFilename è supportato solo per i file di dati primari con estensione mdf.

Se il valore della chiave AttachDBFileName viene specificato nella stringa di connessione, il database viene collegato e diventa il database predefinito per la connessione.

Se questa chiave non viene specificata e se il database è stato collegato in precedenza, il database non verrà ricollegato. Il database collegato in precedenza verrà usato come database predefinito per la connessione.

Se questa chiave viene specificata insieme alla chiave AttachDBFileName, il valore di questa chiave verrà usato come alias. Tuttavia, se il nome è già usato in un altro database collegato, la connessione avrà esito negativo.

Il percorso può essere assoluto o relativo usando la stringa di sostituzione DataDirectory. Se si usa DataDirectory, il file di database deve esistere all'interno di una sottodirectory della directory a cui punta la stringa di sostituzione. Nota: I nomi dei percorsi UNC, HTTP e SERVER remoti non sono supportati.

Il nome del database deve essere specificato con la parola chiave 'database' (o uno dei relativi alias) come indicato di seguito:

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

Verrà generato un errore se esiste un file di log nella stessa directory del file di dati e viene utilizzata la parola chiave 'database' quando ci si collega al file di dati primario. In questo caso, rimuovere il file di log. Una volta collegato il database, verrà automaticamente generato un nuovo file di log in base al percorso fisico.

Si applica a

Vedi anche

• Utilizzo delle stringhe di connessione
• Panoramica del driver SqlClient