SqlConnectionStringBuilder.AttachDBFilename Propriété

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.dll

Obtient ou définit une chaîne qui contient le nom du fichier de données principal. Cela inclut le nom complet du chemin d’accès d’une base de données pouvant être attachée.

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

Valeur de propriété

String

Valeur de la AttachDBFilename propriété, ou String.Empty si aucune valeur n’a été fournie.

Exceptions

ArgumentNullException

Pour définir la valeur sur Null, utilisez Value.

Exemples

L’exemple suivant crée une instance SqlConnectionStringBuilder et définit la AttachDBFilename propriété pour spécifier le nom d’un fichier de données attaché.

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

Remarques

Cette propriété correspond aux clés « AttachDBFilename », « propriétés étendues » et « nom de fichier initial » dans le chaîne de connexion.

AttachDBFilename est uniquement pris en charge pour les fichiers de données principaux avec une extension .mdf.

Une erreur est générée si un fichier journal existe dans le même répertoire que le fichier de données et que le mot clé « base de données » est utilisé lors de l’attachement du fichier de données principal. Dans ce cas, supprimez le fichier journal. Une fois la base de données jointe, un nouveau fichier journal est généré automatiquement en fonction du chemin d’accès physique.

S’applique à

Voir aussi