SqlConnectionStringBuilder.ApplicationName プロパティ

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.dll

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

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 データ プロバイダー" です。

例外

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"

注釈

このプロパティは、接続文字列内の "アプリケーション名" キーと "app" キーに対応します。

こちらもご覧ください

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