Add(String, ELinterDbType, Int32, String)

Метод добавляет в коллекцию параметров с привязкой к указанному столбцу именованный параметр с выделенным буфером заданного размера и с типом данных в терминах СУБД ЛИНТЕР.

Добавление выполняется в конец коллекции, при каждом добавлении выделяется ресурс для размещения параметра.

Максимальное кол-во параметров в коллекции ограничено объемом доступной памяти и не может быть больше значения Int32.MaxValue.

Максимально допустимый размер буфера параметра – 4000 байт.

Если в коллекции уже есть параметр с таким же именем, то будет создан еще один параметр с этим же именем.

Примечание

Данный метод может использоваться в клиентских приложениях, ориентированных исключительно на работу с СУБД ЛИНТЕР.

Синтаксис
public LinterDbParameter Add(string parameterName, ELinterDbType type, int size, string sourceColumn);

parameterName – имя добавляемого параметра (строка длиной не более 66 символов) (свойство ParameterName объекта DbParameter).

type – тип добавляемого параметра в терминах СУБД ЛИНТЕР (см. таблицу 23).

size – размер выделяемого параметру буфера (в байтах).

sourceColumn – имя столбца в наборе DataSet, к которому должен быть привязан добавляемый параметр.

Возвращаемое значение

Параметр, добавленный в коллекцию (значение типа LinterDbParameter).

По умолчанию добавленный параметр имеет следующие свойства:

  • имя параметра (ParameterName) – значение аргумента parameterName;

  • тип данных параметра (DbType) – соответствует аргументу type;

  • значение параметра (Value) – null-значение;

  • вид параметра (Direction) – ParameterDirection.Input;

  • допустимость null-значений (IsNullable) – false;

  • длина значения параметра (Size) – значение аргумента size;

  • имя столбца, к которому привязан параметр (SourceColumn) – значение аргумента sourceColumn;

  • признак допустимости null-значений в наборе данных DataSet (SourceColumnNullMapping) – false;

  • версия столбца в наборе данных DataSet (SourceVersion) – DataRowVersion.Current;

  • тип данных параметра в терминах СУБД ЛИНТЕР (LinterDbType) – значение аргумента type;

  • точность значений параметра (Precision) – 0;

  • масштаб значений параметра (Scale) – 0.

Исключения
OutOfMemoryException Невозможно выделить память под буфер параметра.
OutOfMemoryException, OverflowException Превышено допустимое количество параметров в коллекции (недостаточно ресурсов).

Примечание

Если задан недопустимый размер буфера параметра (больше 4000 байтов) или параметр не имеет тип данных BLOB, то исключение будет сгенерировано при выполнении запроса, а не при выполнении данного метода.

Пример
// C#
using System;
using System.Data;
using System.Data.LinterClient;

class AddSample
{
  static void Main()
  {
    // Создание команды
    LinterDbCommand myCommand = new LinterDbCommand();
    // Создание и добавление параметра в коллекцию
    LinterDbParameter myParam = myCommand.Parameters.Add("MODEL",
      ELinterDbType.NChar, 40, "Model");
  }
}