SqlConnectionStringBuilder.ApplicationName 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

연결 문자열과 관련된 애플리케이션의 이름을 가져오거나 설정합니다.

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

public string ApplicationName { get; set; }

member this.ApplicationName : string with get, set

Public Property ApplicationName As String

속성 값

String

애플리케이션 이름입니다. 이름이 제공되지 않은 경우 .NET Framework 실행할 때 "Framework Microsoft SqlClient 데이터 공급자"이고, 그렇지 않으면 "Core Microsoft SqlClient Data Provider"입니다.

예외

ArgumentNullException

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

예제

다음 예제에서는 새 SqlConnectionStringBuilder를 만들고 개체의 생성자에서 연결 문자열을 할당합니다. 이 코드에서는 구문 분석되고 다시 만들어진 버전의 연결 문자열을 표시한 다음 개체의 ApplicationName 속성을 수정합니다. 마지막으로 새 키/값 쌍이 포함된 새 연결 문자열을 표시합니다.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Server=(local);Initial Catalog=AdventureWorks;" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("ApplicationName={0}",
                builder.ApplicationName);

            builder.ApplicationName = "My Application";
            Console.WriteLine("Modified: " + builder.ConnectionString);

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

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

이 샘플에서는 콘솔 창에 다음 텍스트를 표시합니다.

Original: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
ApplicationName="Core Microsoft SqlClient Data Provider"  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True;Application Name="My Application"  

설명

이 속성은 연결 문자열 내의 "Application Name" 및 "app" 키에 해당합니다.

애플리케이션 이름은 128 자를 사용할 수 있습니다 또는 작습니다.