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"); } }