SqlConnectionStringBuilder.AttachDBFilename Propiedad

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.dll

Obtiene o establece una cadena que contiene el nombre del archivo de datos principal. Esto incluye el nombre de ruta de acceso completo de una base de datos adjuntable.

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

Valor de propiedad

String

Valor de la AttachDBFilename propiedad o String.Empty si no se ha proporcionado ningún valor.

Excepciones

ArgumentNullException

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 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

Comentarios

Esta propiedad corresponde a las claves "AttachDBFilename", "extended properties" y "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.

Se generará un error si existe un archivo de registro en el mismo directorio que el archivo de datos y se usa la palabra clave "database" al adjuntar el archivo de datos principal. En este caso, quite el archivo de registro. Una vez adjuntada la base de datos, se generará automáticamente un nuevo archivo de registro en función de la ruta de acceso física.

Se aplica a

Consulte también