SqlConnectionStringBuilder.AttachDBFilename Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define uma cadeia de caracteres que contém o nome do arquivo de dados primário. Isso inclui o nome de caminho completo de um banco 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, setPublic Property AttachDBFilename As StringValor da propriedade
O valor da propriedade AttachDBFilename ou String.Empty se nenhum valor tiver sido fornecido.
Exceções
Para definir o valor como nulo, use Value.
Exemplos
O exemplo a seguir cria uma nova SqlConnectionStringBuilder instância e define a AttachDBFilename propriedade para especificar o nome de um arquivo 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
Comentários
Essa propriedade corresponde às chaves "AttachDBFilename", "extended properties" e "initial file name" no cadeia de conexão.
AttachDBFilename só há suporte para arquivos de dados primários com uma extensão .mdf.
Um erro será gerado se existir um arquivo de log no mesmo diretório que o arquivo de dados e o palavra-chave 'database' for usado ao anexar o arquivo de dados primário. Nesse caso, remova o arquivo de log. Depois que o banco de dados for anexado, um novo arquivo de log será gerado automaticamente com base no caminho físico.
