SqlConnectionStringBuilder.ApplicationName プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlConnectionStringBuilder.ApplicationName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property ApplicationName As
 String

Visual Basic (使用法)

Dim instance As SqlConnectionStringBuilder
Dim value As String

value = instance.ApplicationName

instance.ApplicationName = value

public string ApplicationName { get;
 set; }

C++

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

/** @property */
public String get_ApplicationName ()

/** @property */
public void set_ApplicationName (String value)

JScript

public function get ApplicationName
 () : String

public function set ApplicationName
 (value : String)

プロパティ値
アプリケーション名。アプリケーション名を指定しなかった場合は、".NET SqlClient Data Provider"。

解説

このプロパティは、接続文字列内の "Application Name" キーおよび "app" キーに対応します。プロパティを設定するときに渡された値が null の場合、ApplicationName プロパティはリセットされます。値が設定されていない場合に開発者がプロパティを取得しようとすると、String.Empty が返されます。

使用例

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

Visual Basic

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

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);
        }
    }
}

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

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"