다음을 통해 공유


SqlConnectionStringBuilder.InitialCatalog 속성

정의

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

public:
 property System::String ^ InitialCatalog { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))]
public string InitialCatalog { get; set; }
public string InitialCatalog { get; set; }
[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))>]
member this.InitialCatalog : string with get, set
member this.InitialCatalog : string with get, set
Public Property InitialCatalog As String

속성 값

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

특성

예외

값을 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자 이하일 수 있습니다.

적용 대상