SqlConnectionStringBuilder.ApplicationName Eigenschaft

Definition

Ruft den Namen der Verbindungszeichenfolge zugeordneten Anwendung ab oder legt einen Namen fest.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

Eigenschaftswert

Der Name der Anwendung oder ".NET SQLClient Data Provider", wenn kein Anwendungsname angegeben wurde.The name of the application, or ".NET SqlClient Data Provider" if no name has been supplied.

Ausnahmen

Verwenden Sie Value, um den Wert auf NULL festzulegen.To set the value to null, use Value.

Beispiele

Im folgenden Beispiel wird ein neuer SqlConnectionStringBuilder erstellt und eine Verbindungszeichenfolge im Konstruktor des Objekts zugewiesen.The following example creates a new SqlConnectionStringBuilder and assigns a connection string in the object's constructor. Im Code wird die analysierte und neu erstellte Version der Verbindungszeichenfolge angezeigt, und anschließend wird die ApplicationName-Eigenschaft des Objekts geändert.The code displays the parsed and recreated version of the connection string, and then modifies the ApplicationName property of the object. Zuletzt wird im Code die neue Verbindungszeichenfolge einschließlich des neuen Schlüssel-Wert-Paares angezeigt.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

Im Beispiel wird der folgende Text im Konsolenfenster angezeigt: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"  

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Application Name" und "app" in der Verbindungszeichenfolge.This property corresponds to the "Application Name" and "app" keys within the connection string.

Gilt für:

Siehe auch