SqlConnectionStringBuilder.AttachDBFilename 属性

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.dll

获取或设置一个字符串，其中包含主数据文件的名称。 这包括可附加数据库的完整路径名称。

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 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”、“扩展属性”和“初始文件名”键。

AttachDBFilename 仅支持扩展名为 .mdf 的主数据文件。

如果日志文件与数据文件位于同一目录中，并且附加主数据文件时使用“database”关键字，则会生成错误。 在这种情况下，请删除日志文件。 附加数据库后，将基于物理路径自动生成新的日志文件。

另请参阅

• ADO.NET 中的连接字符串
• ADO.NET 概述