SqlConnectionStringBuilder.ApplicationName Property

Definition

获取或设置与连接字符串关联的应用程序的名称。Gets or sets the name of the application associated with the connection string.

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

Property Value

String

应用程序的名称;或者,如果未提供名称,则为“.NET SqlClient Data Provider”。The name of the application, or ".NET SqlClient Data Provider" if no name has been supplied.

Exceptions

若要将值设置为 null,请使用 ValueTo set the value to null, use Value.

Examples

以下示例创建一个新的 SqlConnectionStringBuilder 并在对象的构造函数中分配一个连接字符串。The following example creates a new SqlConnectionStringBuilder and assigns a connection string in the object's constructor. 该代码显示已分析并重新创建的版本的连接字符串,然后修改对象的 ApplicationName 属性。The code displays the parsed and recreated version of the connection string, and then modifies the ApplicationName property of the object. 最后,该代码显示包含新键/值对的新连接字符串。Finally, the code displays the new connection string, including the new key/value pair.

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

该示例在控制台窗口中显示以下文本:The sample displays the following text in the console window:

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"

Remarks

此属性与连接字符串内的“Application Name”和“app”键相对应。This property corresponds to the "Application Name" and "app" keys within the connection string.

Applies to

See also