SqlConnectionStringBuilder.InitialCatalog 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

연결과 연결된 데이터베이스의 이름을 가져오거나 설정합니다.

public:
 property System::String ^ InitialCatalog { System::String ^ get(); void set(System::String ^ value); };

public string InitialCatalog { get; set; }

member this.InitialCatalog : string with get, set

Public Property InitialCatalog As String

속성 값

String

InitialCatalog 속성의 값이거나, 제공된 값이 없으면 String.Empty입니다.

예외

ArgumentNullException

값을 null로 설정하려면 Value를 사용합니다.

예제

다음 예제에서는 간단한 연결 문자열을 만든 다음 SqlConnectionStringBuilder 클래스를 사용하여 데이터베이스의 이름을 연결 문자열에 추가합니다. 이 코드에서는 클래스가 동의어("Database")를 적절한 속성 값으로 변환할 수 있었는지를 확인하기 위해 InitialCatalog 속성의 내용을 표시합니다.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Data Source=(local);" +
                "Integrated Security=true";

            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Normally, you could simply set the InitialCatalog
            // property of the SqlConnectionStringBuilder object. This
            // example uses the default Item property (the C# indexer)
            // and the "Database" string, simply to demonstrate that
            // setting the value in this way results in the same
            // connection string:
            builder["Database"] = "AdventureWorks";
            Console.WriteLine("builder.InitialCatalog = "
                + builder.InitialCatalog);
            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection connection =
                new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

설명

이 속성은 연결 문자열 내의 "Initial Catalog" 및 "database" 키에 해당합니다.

데이터베이스 이름은 128자 이하일 수 있습니다.