SqlConnectionStringBuilder.ApplicationName Vlastnost

Reference

Definice

Obor názvů:: System.Data.SqlClient

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Balíček:: System.Data.SqlClient v4.8.6

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název aplikace přidružené k připojovací řetězec.

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

Hodnota vlastnosti

String

Název aplikace nebo ".NET SqlClient Data Provider", pokud nebyl zadán žádný název.

Výjimky

ArgumentNullException

Pokud chcete nastavit hodnotu na null, použijte Value.

Příklady

Následující příklad vytvoří nový SqlConnectionStringBuilder a přiřadí připojovací řetězec v konstruktoru objektu. Kód zobrazí parsovanou a znovu vytvořenou verzi připojovací řetězec a pak upraví ApplicationName vlastnost objektu. Nakonec kód zobrazí novou připojovací řetězec, včetně nového páru klíč/hodnota.

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

Ukázka zobrazí v okně konzoly následující text:

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"

Poznámky

Tato vlastnost odpovídá klíčům "Application Name" a "app" v rámci připojovací řetězec.

Platí pro