SqlConnectionStringBuilder.AttachDBFilename 속성

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.8.6

주 데이터 파일의 이름이 포함된 문자열을 가져오거나 설정합니다. 이 문자열에는 연결할 수 있는 데이터베이스의 전체 경로 이름이 들어 있습니다.

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 instance 만들고 연결된 데이터 파일의 이름을 지정하기 위해 속성을 설정합니다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", "extended properties" 및 "initial file name" 키에 해당합니다.

AttachDBFilename 는 .mdf 확장이 있는 기본 데이터 파일에 대해서만 지원됩니다.

로그 파일이 데이터 파일과 같은 디렉터리에 있고 주 데이터 파일을 연결할 때 'database' 키워드가 사용되면 오류가 생성됩니다. 이 경우에는 로그 파일을 제거해야 합니다. 데이터베이스가 연결되면 새 로그 파일이 실제 경로에 따라 자동으로 생성됩니다.

추가 정보

• ADO.NET의 연결 문자열
• ADO.NET 개요