SqlConnectionStringBuilder.AttachDBFilename Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает строку, содержащую имя первичного файла данных. Оно включает полный путь к подключаемой базе данных.

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

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

String

Значение свойства AttachDBFilename или String.Empty, если значение не указано.

Исключения

ArgumentNullException

Чтобы задать значение NULL, используйте Value.

Примеры

В следующем примере создается новый SqlConnectionStringBuilder экземпляр и задается AttachDBFilename свойство , чтобы указать имя вложенного файла данных.

using Microsoft.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);
        }
    }
}

Комментарии

Это свойство соответствует ключам «AttachDBFilename» и «extended properties» и «initial file name» в строке подключения.

AttachDBFilename поддерживается только для основных файлов данных с расширением MDF.

Если в строке подключения указано значение ключа AttachDBFileName, база данных присоединяется и становится базой данных по умолчанию для подключения.

Если этот ключ не указан и если база данных была ранее подключена, то повторное присоединение базы данных не будет. Ранее присоединенная база данных будет использоваться в качестве базы данных по умолчанию для подключения.

Если этот ключ указан вместе с ключом AttachDBFileName, значение этого ключа будет использоваться в качестве псевдонима. Однако если имя уже используется в другой подключенной базе данных, подключение завершится ошибкой.

Путь может быть абсолютным или относительным с помощью строки подстановки DataDirectory. Если используется DataDirectory, файл базы данных должен находиться в подкаталоге каталога, на который указывает строка подстановки. Примечание: Имена путей удаленного сервера, HTTP и UNC не поддерживаются.

Имя базы данных должно быть указано с помощью ключевое слово database (или одного из ее псевдонимов), как показано ниже:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Если файл журнала находится в том же каталоге, что и файл данных, а при прикреплении первичного файла данных было использовано ключевое слово «database», будет выдана ошибка. В этом случае следует удалить файл журнала. После прикрепления базы данных будет автоматически создан новый файл журнала на основе физического пути.

См. также раздел

• Работа со строками подключения
• Общие сведения о драйвере SqlClient