SqlConnectionStringBuilder.ApplicationName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает имя приложения, связанного со строкой подключения.
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
Значение свойства
Имя приложения. Если имя не указано, "Поставщик данных Платформы Microsoft SqlClient" при запуске на платформа .NET Framework и "Поставщик данных Core Microsoft SqlClient" в противном случае.
Исключения
Чтобы задать значение 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 символов.