SqlConnectionStringBuilder.ApplicationName Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta il nome dell'applicazione associata alla stringa di connessione.

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

Valore della proprietà

String

Nome dell'applicazione. Se non è stato specificato alcun nome, "Framework Microsoft SqlClient Data Provider" durante l'esecuzione in .NET Framework e "Core Microsoft SqlClient Data Provider" in caso contrario.

Eccezioni

ArgumentNullException

Per impostare il valore su Null, usare Value.

Esempio

Nel seguente esempio viene creato un nuovo oggetto SqlConnectionStringBuilder e viene assegnata una stringa di connessione nel costruttore dell'oggetto. Il codice visualizza la versione analizzata e ricreata della stringa di connessione, quindi modifica la proprietà dell'oggetto ApplicationName. Infine, il codice visualizza la nuova stringa di connessione, inclusa la nuova coppia chiave/valore.

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

Nell'esempio viene visualizzato il seguente testo nella finestra della console:

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"  

Commenti

Questa proprietà corrisponde alle chiavi "Application Name" e "app" all'interno della stringa di connessione.

Un nome dell'applicazione può essere di 128 caratteri o meno.