SqlConnectionStringBuilder.InitialCatalog 속성

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.8.6

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

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

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))]
public string InitialCatalog { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))>]
member this.InitialCatalog : string with get, set

Public Property InitialCatalog As String

속성 값

String

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

특성

TypeConverterAttribute

예외

ArgumentNullException

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

예제

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

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

Imports System.Data.SqlClient
    
Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
             "Data Source=(local);" & _
             "Integrated Security=True"

            Dim builder As 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 connection As New SqlConnection(builder.ConnectionString)
                connection.Open()
                ' Now use the open connection.
                Console.WriteLine("Database = " & connection.Database)
            End Using

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try

        Console.WriteLine("Press any key to finish.")
        Console.ReadLine()
    End Sub
End Module

설명

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

추가 정보

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