SqlConnectionStringBuilder.ApplicationName Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el nombre de la aplicación asociada a la cadena de conexión.

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

Valor de propiedad

String

Nombre de la aplicación. Si no se ha proporcionado ningún nombre, "Proveedor de datos SqlClient de Microsoft Framework" al ejecutarse en .NET Framework y "Core Microsoft SqlClient Data Provider" de lo contrario.

Excepciones

ArgumentNullException

Para establecer el valor en null, use Value.

Ejemplos

El ejemplo siguiente crea una SqlConnectionStringBuilder nueva y asigna una cadena de conexión en el constructor del objeto. El código muestra la versión analizada y recreada de la cadena de conexión y, a continuación, modifica la propiedad ApplicationName del objeto. Finalmente, el código muestra la nueva cadena de conexión, incluyendo el nuevo para clave-valor.

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

El ejemplo muestra el texto siguiente en la ventana de consola:

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"  

Comentarios

Esta propiedad se corresponde con las claves "Application Name" y "app" dentro de la cadena de conexión .

Un nombre de aplicación puede tener 128 caracteres o menos.