SqlConnectionStringBuilder.ApplicationName Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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

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 Pokud nebyl zadán žádný název, "Framework Microsoft SqlClient Data Provider" při spuštění v rozhraní .NET Framework a "Core Microsoft SqlClient Data Provider" v opačném případě.

Výjimky

ArgumentNullException

Pokud chcete nastavit hodnotu na hodnotu 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í analyzovanou a znovu vytvořenou verzi připojovacího řetězce a pak upraví ApplicationName vlastnost objektu. Nakonec kód zobrazí nový připojovací řetězec, včetně nového páru klíč/hodnota.

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

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

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"  

Poznámky

Tato vlastnost odpovídá klíčům "Název aplikace" a "app" v rámci připojovacího řetězce.

Název aplikace může být delší než 128 znaků.