ConnectKit 8.6.4

ConnectKit

Диалог подключения к SQL Server и утилиты для быстрого формирования строк подключения.

Установка

dotnet add package ConnectKit

API-справочник

Класс ConnectionDialog

WinForms-диалог для подключения к SQL Server. Поддерживает Windows-аутентификацию и SQL-аутентификацию, загрузку списка баз данных и тестирование подключения.

Свойство ConnectionString

Возвращает строку подключения, сформированную на основе введенных данных.

using var dialog = new ConnectionDialog();
if (dialog.ShowDialog() == DialogResult.OK)
{
    string cs = dialog.ConnectionString;
}

Статический метод Show(IWin32Window? owner = null)

Показывает диалог подключения и возвращает строку подключения или null при отмене.

string? connectionString = ConnectionDialog.Show();
if (connectionString != null)
{
    // Использовать строку подключения
}

Класс QuickConnect

Статический класс для быстрого формирования строк подключения.

SqlServer(string server, string database)

Формирует строку подключения к SQL Server с Windows-аутентификацией.

string cs = QuickConnect.SqlServer("MYSERVER", "MyDatabase");

LocalDb(string database)

Формирует строку подключения к LocalDB.

string cs = QuickConnect.LocalDb("MyDatabase");

Test(string connectionString)

Синхронно проверяет подключение к SQL Server. Возвращает true при успехе, false при ошибке.

bool ok = QuickConnect.Test(connectionString);
if (ok)
    MessageBox.Show("Подключение успешно!");

TestAsync(string connectionString)

Асинхронно проверяет подключение к SQL Server. Возвращает true при успехе, false при ошибке.

bool ok = await QuickConnect.TestAsync(connectionString);

Особенности диалога ConnectionDialog

• Поддержка Windows-аутентификации и SQL-аутентификации (логин/пароль).
• Кнопка "Загрузить БД" для получения списка баз данных с сервера.
• Кнопка "Тест подключения" для проверки соединения.
• Автоматическая проверка подключения при нажатии OK.
• Визуальная индикация статуса (цветные сообщения).

Примеры использования

Диалог подключения в приложении

using ConnectKit;

string? cs = ConnectionDialog.Show(this);
if (cs != null)
{
    var optionsBuilder = new DbContextOptionsBuilder<MyDbContext>();
    optionsBuilder.UseSqlServer(cs);
    using var context = new MyDbContext(optionsBuilder.Options);
    // Работа с контекстом
}

Быстрое подключение без диалога

using ConnectKit;

// Подключение к локальному серверу
string cs = QuickConnect.SqlServer("localhost", "EmploymentAgency");

// Или к LocalDB
string csLocal = QuickConnect.LocalDb("EmploymentAgency");

// Проверка перед использованием
bool ok = await QuickConnect.TestAsync(cs);
if (ok)
{
    var builder = new DbContextOptionsBuilder<MyDbContext>();
    builder.UseSqlServer(cs);
    using var context = new MyDbContext(builder.Options);
}
else
{
    MessageBox.Show("Не удалось подключиться к серверу.");
}