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 数据提供程序”，否则为“Core Microsoft SqlClient 数据提供程序”。

例外

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 个字符。