ЛИНТЕР

Add(String, ELinterDbType, Int32)

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

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

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

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

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

Примечание

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

Синтаксис

public LinterDbParameter Add(string parameterName, ELinterDbType type, int size);

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

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

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

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

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

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

имя параметра (ParameterName) – значение аргумента parameterName;
тип данных параметра (DbType) – соответствует аргументу type;
значение параметра (Value) – null-значение;
вид параметра (Direction) – ParameterDirection.Input;
допустимость null-значений (IsNullable) – false;
длина значения параметра (Size) – значение аргумента size;
имя столбца, к которому привязан параметр (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);
  }
}