SqlConnectionStringBuilder.AttachDBFilename Свойство

Определение

Возвращает или задает строку, содержащую имя первичного файла данных.Gets or sets a string that contains the name of the primary data file. Оно включает полный путь к подключаемой базе данных.This includes the full path name of an attachable database.

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

Значение свойства

Значение свойства AttachDBFilename или String.Empty, если значение не указано.The value of the AttachDBFilename property, or String.Empty if no value has been supplied.

Исключения

Чтобы задать значение NULL, используйте Value.To set the value to null, use Value.

Примеры

В следующем примере создается новый экземпляр SqlConnectionStringBuilder и устанавливается свойство AttachDBFilename, чтобы указать имя присоединенного файла данных.The following example creates a new SqlConnectionStringBuilder instance, and sets the AttachDBFilename property in order to specify the name of an attached data file.

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

Комментарии

Это свойство соответствует ключам «AttachDBFilename» и «extended properties» и «initial file name» в строке подключения.This property corresponds to the "AttachDBFilename", "extended properties", and "initial file name" keys within the connection string.

AttachDBFilename поддерживается только для первичных файлов данных с расширением MDF.AttachDBFilename is only supported for primary data files with an .mdf extension.

Если файл журнала находится в том же каталоге, что и файл данных, а при прикреплении первичного файла данных было использовано ключевое слово «database», будет выдана ошибка.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. В этом случае следует удалить файл журнала.In this case, remove the log file. После прикрепления базы данных будет автоматически создан новый файл журнала на основе физического пути.Once the database is attached, a new log file will be automatically generated based on the physical path.

Применяется к

Дополнительно