SqlConnectionStringBuilder.ApplicationName Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает имя приложения, связанного со строкой подключения.

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

Значение свойства

String

Имя приложения. Если имя не указано, "Поставщик данных Платформы Microsoft SqlClient" при запуске на платформа .NET Framework и "Поставщик данных Core Microsoft SqlClient" в противном случае.

Исключения

ArgumentNullException

Чтобы задать значение NULL, используйте Value.

Примеры

В следующем примере кода создается новый объект SqlConnectionStringBuilder, а затем в конструкторе объекта присваивается строка подключения. Код отображает проанализированную и повторно созданную версию строки подключения, затем изменяет свойство ApplicationName объекта. Наконец, код отображает новую строку подключения, включая новую пару «ключ-значение».

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

В этом примере в окне консоли отображается следующий текст:

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"  

Комментарии

Это свойство соответствует ключам «Application Name» и «app» в строке подключения.

Имя приложения может содержать не более 128 символов.