SqlConnectionStringBuilder.ApplicationName Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit le nom de l'application associée à la chaîne de connexion.

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

Valeur de propriété

String

Le nom de l’application. Si aucun nom n’a été fourni, « Fournisseur de données Framework Microsoft SqlClient » lors de l’exécution sur .NET Framework et « Fournisseur de données Microsoft SqlClient core » dans le cas contraire.

Exceptions

ArgumentNullException

Pour définir la valeur sur null, utilisez Value.

Exemples

L'exemple suivant crée un SqlConnectionStringBuilder et assigne une chaîne de connexion dans le constructeur de l'objet. Le code affiche la version analysée et recréée de la chaîne de connexion, puis modifie la propriété ApplicationName de l'objet. Enfin, le code affiche la nouvelle chaîne de connexion, y compris la nouvelle paire clé/valeur.

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

L'exemple affiche le texte suivant dans la fenêtre de 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"  

Remarques

Cette propriété correspond aux clés « Application Name » et « app » dans la chaîne de connexion.

Un nom d’application peut comporter 128 caractères ou moins.