Add(String, ELinterDbType, Int32)
Метод добавляет в коллекцию параметров именованный параметр с выделенным буфером заданного размера и с типом данных в терминах СУБД ЛИНТЕР.
Добавление выполняется в конец коллекции, при каждом добавлении выделяется ресурс для размещения параметра.
Максимальное количество параметров в коллекции ограничено объемом доступной памяти и не может быть больше значения Int32.MaxValue.
Максимально допустимый размер буфера параметра – 4000 байт.
Если в коллекции уже есть параметр с таким же именем, то будет создан еще один параметр с этим же именем.
Примечание
Данный метод может использоваться в клиентских приложениях, ориентированных исключительно на работу с СУБД ЛИНТЕР.
Синтаксис
public LinterDbParameter Add(string parameterName, ELinterDbType type, int size);
parameterName
– имя добавляемого параметра (строка длиной не более 66 символов) (свойство ParameterName объекта DbParameter
).
type
– тип добавляемого параметра в терминах СУБД ЛИНТЕР (см. таблицу 23).
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); } }