SqlConnectionStringBuilder.AttachDBFilename Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece una cadena que contiene el nombre del archivo de datos principal. La cadena incluye el nombre completo de la ruta de acceso a una base de datos asociable.
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 StringValor de propiedad
El valor de la propiedad AttachDBFilename, o String.Empty si no se ha proporcionado ningún valor.
Excepciones
Para establecer el valor en null, use Value.
Ejemplos
En el ejemplo siguiente se crea una nueva SqlConnectionStringBuilder instancia y se establece la AttachDBFilename propiedad para especificar el nombre de un archivo de datos adjunto.
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);
}
}
}
Comentarios
Esta propiedad se corresponde con las claves "AttachDBFilenames", "extended properties" e "initial file name" dentro de la cadena de conexión .
AttachDBFilename solo se admite para los archivos de datos principales con una extensión .mdf.
Si el valor de la clave AttachDBFileName se especifica en la cadena de conexión, la base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión.
Si no se especifica esta clave y si la base de datos se adjuntó anteriormente, la base de datos no se volverá a adjuntar. La base de datos adjunta anteriormente se usará como base de datos predeterminada para la conexión.
Si esta clave se especifica junto con la clave AttachDBFileName, el valor de esta clave se usará como alias. Sin embargo, si el nombre ya se usa en otra base de datos adjunta, se producirá un error en la conexión.
La ruta de acceso puede ser absoluta o relativa mediante la cadena de sustitución DataDirectory. Si se usa DataDirectory, el archivo de base de datos debe existir dentro de un subdirectorio del directorio al que apunta la cadena de sustitución. Nota: No se admiten los nombres de ruta de acceso de servidor remoto, HTTP y UNC.
El nombre de la base de datos debe especificarse con la palabra clave 'database' (o uno de sus alias) como se indica a continuación:
"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"
Se generará un error si existe un archivo de registro en el mismo directorio que el archivo de datos y se utiliza la palabra clave 'database' al adjuntar el archivo de datos primario. En este caso, se debe quitar el archivo de registro. Una vez la base de datos has sido asociada, se generará automáticamente un nuevo archivo de registro basado en la ruta de acceso física.