Решение ошибки в VB.NET: параметр в SQL запросе не предоставлен

Быстрый ответ

Если вы столкнулись с ошибкой "не предоставлен параметр", это говорит о том, что есть несоответствие между ожидаемыми параметрами в вашем SQL-запросе и теми, которые были фактически переданы. Важно, чтобы каждому указанному в запросе @параметру было присвоено значение перед выполнением запроса:

DECLARE @UserID int = 1;  -- Присваиваем значение напрямую
SELECT * FROM Users WHERE UserID = @UserID;  -- Используем параметр в запросе

Уделяя должное внимание присваиванию значений, вы сможете избежать подобных ошибок.

Проблема "без параметров": Работа с null-значениями

При работе с параметрами, особенно когда они получены из пользовательского ввода, проверьте их на null. Для корректной передачи null-значений в базу данных используйте DBNull.Value:

// При наличии пустых полей передаём DBNull
if (string.IsNullOrEmpty(textbox.Text))
{
    command.Parameters.AddWithValue("@ParameterName", DBNull.Value);
}
else
{
    command.Parameters.AddWithValue("@ParameterName", textbox.Text);
}

Для точной соблюдения соответствия типов данных параметра, используйте SqlDbType:

command.Parameters.Add("@StringParameter", SqlDbType.VarChar).Value = myString;

Формализованный подход к работе с параметрами обеспечивает защиту от SQL-инъекций и гарантирует корректность данных.

Работа с динамическими вводами в реальном времени

Обработка динамического пользовательского ввода, например, при изменении текста, включает в себя очистку предыдущих результатов и представление новых данных на основе текущего ввода:

private void TextBox_TextChanged(object sender, EventArgs e)
{
    // Всегда очищаем прошлые данные перед добавлением новых
    myListBox.Clear();

    using (SqlCommand command = new SqlCommand(query, connection))
    {
        // Присваиваем параметру значение или DBNull в случае пустого ввода
        command.Parameters.AddWithValue("@Parameter", TextBox.Text ?? DBNull.Value);
        // Выполняем запрос с обновлёнными данными
        // ...
    }
}

Защитите выполнение запросов от ошибок, управляя строками, добавленными пользователем в привязанных к данным элементах управления, таких как DataGridView.

Искусство работы с параметрами: Настройка кода

Преобразование Null в совместимое значение

При работе с null-значениями, для корректной обработки их в вашем приложении передавайте их как DBNull.Value:

// Преобразуем null в DBNull для корректной передачи
command.Parameters.AddWithValue("@NullableParameter", myObject.SomeProperty ?? DBNull.Value);

Подробнее об этом расскажет наш спикер на видео

Типизация параметров

Для корректной работы с базой данных используйте типизированные параметры, например SqlDbType.VarChar:

// Корректное использование строки в запросе
command.Parameters.Add("@StringParameter", SqlDbType.VarChar, 50).Value = myStringValue;

Проверка данных перед запросом

Убедитесь в корректности данных перед отправкой запроса, используя условные операторы:

// Проверяем данные перед выполнением запроса
if (!string.IsNullOrWhiteSpace(TextBox.Text))
{
    // Данные корректны, выполняем запрос
}

Соответствие параметров

Проверьте соответствие параметров и операторов в тексте SQL-запроса, чтобы избежать ошибок:

Визуализация

Представьте SQL-запрос как паровоз (🚂), где каждый вагон (🚃) – это параметр, ожидающий заполнения значением:

Правильный паровоз: 🚂🚃(значение1)🚃(значение2)🚃(значение3)
Проблемный паровоз: 🚂🚃(???)🚃(значение2)🚃(значение3)

Паровоз отправится только когда все вагоны будут надлежащим образом загружены:

Правильно: 🚂🚃(значение)🚃(значение)🚃(значение)
Ошибка: 🚂🚃(???) 🚨 <- Кто-то забыл зарегистрировать багаж!

Для исправления, просто свяжите каждый параметр со своим значением:

До: EXEC sp_add_job @job_name='BackupJob'    ❌
После: EXEC sp_add_job @job_name='BackupJob', @enabled=1 ✅

Теперь запрос-паровоз может отправиться, когда каждый параметр на месте:

Исправленный паровоз: 🚂🚃(значение1)🚃(значение2)🚃(значение3)

Не предоставленный параметр – это пустой вагон, который останавливает движение паровоза.

Полезные материалы

1. Класс SqlParameter (System.Data.SqlClient) | Microsoft Docs — Руководство по использованию SqlParameter.
2. Избегайте SQL инъекций с засекреченными запросами — Обсуждение параметризованных запросов на StackOverflow
3. Обзор архитектуры обработки запросов SQL Server — Основы работы SQL Server с параметрами.
4. Предотвращение SQL-инъекций – Руководство по предотвращению SQL-инъекций на OWASP.
5. Настройка параметров и типов данных параметров — О том, как правильно подготовить типы данных параметров.