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 Data Provider" 、それ以外の場合は "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 文字以下を指定できます。