SqlConnectionStringBuilder.AttachDBFilename Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta una stringa contenente il nome del file di dati primario. Questo include il nome completo del percorso di un database a cui è possibile collegarsi.
public:
property System::String ^ AttachDBFilename { System::String ^ get(); void set(System::String ^ value); };public string AttachDBFilename { get; set; }member this.AttachDBFilename : string with get, setPublic Property AttachDBFilename As StringValore della proprietà
Valore della proprietà AttachDBFilename o String.Empty se non è stato fornito alcun valore.
Eccezioni
Per impostare il valore su Null, usare Value.
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.