SqlConnectionStringBuilder.ApplicationName プロパティ

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.SqlClient.dll

パッケージ:

System.Data.SqlClient v4.8.6

接続文字列に関連付けられたアプリケーションの名前を取得または設定します。

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 SqlClient Data Provider"。

例外

ArgumentNullException

値を null に設定するには、Value を使用します。

例

次の例では、新しい SqlConnectionStringBuilder を作成し、オブジェクトのコンストラクターで接続文字列を割り当てます。 コードでは、解析および再作成されたバージョンの接続文字列を表示し、オブジェクトの ApplicationName プロパティを変更しています。 コードでは最後に、新しいキー/値ペアが含まれた新しい接続文字列を表示しています。

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

Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Try
            Dim connectString As String = _
             "Server=(local);Initial Catalog=AdventureWorks;" & _
                 "Integrated Security=True"
            Dim builder As 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 ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Sub
End Module

このサンプルでは、次のテキストがコンソール ウィンドウに表示されます。

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

注釈

このプロパティは、接続文字列内の "Application Name" キーおよび "app" キーに対応しています。

こちらもご覧ください

• 接続文字列 (ADO.NET)
• ADO.NET の概要