SqlConnectionStringBuilder.ApplicationName プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
接続文字列に関連付けられたアプリケーションの名前を取得または設定します。
public:
property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };public string ApplicationName { get; set; }member this.ApplicationName : string with get, setPublic Property ApplicationName As Stringプロパティ値
アプリケーションの名前です。 名前が指定されていない場合は、.NET Frameworkで実行されている場合は "Framework Microsoft SqlClient Data Provider" 、それ以外の場合は "Core Microsoft SqlClient Data Provider" になります。
例外
値を 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 文字以下を指定できます。