SqlConnectionStringBuilder.ApplicationName Propriedade

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Recebe ou define o nome da aplicação associada à cadeia de ligaçã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 de Propriedade

String

O nome da aplicação, ou ".NET SqlClient Data Provider" caso não tenha sido fornecido o nome.

Exceções

ArgumentNullException

Para definir o valor como nulo, use Value.

Exemplos

O exemplo seguinte cria um novo SqlConnectionStringBuilder e atribui uma cadeia de ligação no construtor do objeto. O código mostra a versão analisada e recriada do cadeia de ligação, e depois modifica a propriedade ApplicationName do objeto. Finalmente, o código mostra a nova cadeia de ligação, incluindo o novo par chave/valor.

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 mostra o seguinte texto na janela da consola:

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"

Observações

Esta propriedade corresponde às teclas "Application Name" e "app" dentro da cadeia de ligação.

Aplica-se a

Ver também