Add(String, Object)

Метод добавляет в коллекцию параметров именованный параметр с указанным значением.

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

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

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

Примечание

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

Синтаксис
public LinterDbParameter Add(string parameterName, object value);

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

value – значение добавляемого параметра (свойство Value объекта DbParameter).

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

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

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

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

  • тип данных параметра (DbType) – тип данных аргумента value;

  • значение параметра (Value) – значение аргумента value;

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

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

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

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

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

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

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

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

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

Исключения
OutOfMemoryException, OverflowException Превышено допустимое количество параметров в коллекции (недостаточно ресурсов).
Пример
// 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",
      "CADILLAC FLEETWOOD");
  }
}