SqlConnectionStringBuilder.ApplicationName Propriedade

Definição

Obtém ou define o nome do aplicativo associado à cadeia de conexão.Gets or sets the name of the application associated with the connection string.

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 ou “Provedor de Dados .NET SqlClient” se nenhum nome foi fornecido.The name of the application, or ".NET SqlClient Data Provider" if no name has been supplied.

Exceções

Para definir o valor como nulo, use Value.To set the value to null, use Value.

Exemplos

O exemplo a seguir cria um novo SqlConnectionStringBuilder e atribui uma cadeia de conexão no construtor do objeto.The following example creates a new SqlConnectionStringBuilder and assigns a connection string in the object's constructor. O código exibe a versão analisada e recriada da cadeia de conexão e, em seguida, modifica a ApplicationName Propriedade do objeto.The code displays the parsed and recreated version of the connection string, and then modifies the ApplicationName property of the object. Por fim, o código exibe a nova cadeia de conexão, incluindo o novo par chave/valor.Finally, the code displays the new connection string, including the new key/value pair.

using System.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);
        }
    }
}
Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Try
            Dim connectString As String = _
             "Server=(local);Initial Catalog=AdventureWorks;" & _
                 "Integrated Security=True"
            Dim builder As 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 ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Sub
End Module

O exemplo exibe o seguinte texto na janela do console:The sample displays the following text in the console window:

Original: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
ApplicationName=".Net 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" na cadeia de conexão.This property corresponds to the "Application Name" and "app" keys within the connection string.

Aplica-se a