SqlConnectionStringBuilder.AttachDBFilename Propriedade

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Recebe ou define uma cadeia que contém o nome do ficheiro de dados principal. Isto inclui o nome completo do caminho de uma base de dados anexável.

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 Propriedade

String

O valor da AttachDBFilename propriedade, ou String.Empty se não tiver sido fornecido valor.

Exceções

ArgumentNullException

Para definir o valor como nulo, use Value.

Exemplos

O exemplo seguinte cria uma nova SqlConnectionStringBuilder instância e define a AttachDBFilename propriedade para especificar o nome de um ficheiro de dados anexado.

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

Observações

Esta propriedade corresponde às chaves "AttachDBFilename", "extended properties" e "initial file name" dentro da cadeia de ligação.

AttachDBFilename é suportado apenas para ficheiros de dados primários com extensão .mdf.

Será gerado um erro se existir um ficheiro de registo no mesmo diretório que o ficheiro de dados e a palavra-chave 'base de dados' for usada ao anexar o ficheiro de dados primário. Neste caso, remove o ficheiro de registo. Uma vez anexada a base de dados, um novo ficheiro de registo será automaticamente gerado com base no caminho físico.

Aplica-se a

Ver também