SqlConnectionStringBuilder.ApplicationName Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft den Namen der Verbindungszeichenfolge zugeordneten Anwendung ab oder legt einen Namen fest.

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

String

Der Namen der Anwendung. Wenn kein Name angegeben wurde, "Framework Microsoft SqlClient-Datenanbieter" bei ausführung unter .NET Framework und "Core Microsoft SqlClient-Datenanbieter".

Ausnahmen

ArgumentNullException

Verwenden Sie Value, um den Wert auf NULL festzulegen.

Beispiele

Im folgenden Beispiel wird ein neuer SqlConnectionStringBuilder erstellt und eine Verbindungszeichenfolge im Konstruktor des Objekts zugewiesen. Im Code wird die analysierte und neu erstellte Version der Verbindungszeichenfolge angezeigt, und anschließend wird die ApplicationName-Eigenschaft des Objekts geändert. Zuletzt wird im Code die neue Verbindungszeichenfolge einschließlich des neuen Schlüssel-Wert-Paares angezeigt.

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);
        }
    }
}

Im Beispiel wird der folgende Text im Konsolenfenster angezeigt:

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"  

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Application Name" und "app" in der Verbindungszeichenfolge.

Ein Anwendungsname kann maximal 128 Zeichen lang sein.