SqlConnectionStringBuilder.ApplicationName Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém ou define o nome do aplicativo associado à cadeia de conexão.

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 da propriedade

String

O nome do aplicativo. Se nenhum nome tiver sido fornecido, "Provedor de Dados Framework Microsoft SqlClient" ao executar em .NET Framework e "Provedor de Dados Principais do Microsoft SqlClient" caso contrário.

Exceções

ArgumentNullException

Para definir o valor como nulo, use Value.

Exemplos

O exemplo a seguir cria um novo SqlConnectionStringBuilder e atribui uma cadeia de conexão no construtor do objeto. O código exibe a versão analisada e recriada da cadeia de conexão e modifica a ApplicationName propriedade do objeto. Por fim, o código exibe a nova cadeia de conexão, incluindo o novo par chave/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);
        }
    }
}

O exemplo exibe o seguinte texto na janela do 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"  

Comentários

Essa propriedade corresponde às chaves "Nome do Aplicativo" e "aplicativo" dentro da cadeia de conexão.

Um nome de aplicativo pode ter 128 caracteres ou menos.