SqlConnectionStringBuilder.ApplicationName プロパティ

.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

C#

public string ApplicationName { get;
 set; }

C++

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

J#

/** @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

C#

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"

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlConnectionStringBuilder クラス
SqlConnectionStringBuilder メンバ
System.Data.SqlClient 名前空間
その他の技術情報
接続文字列の使用