Add(Object)
Метод добавляет параметр в коллекцию параметров.
Добавление выполняется в конец коллекции. В коллекции при каждом добавлении выделяется ресурс для размещения параметра. Максимальное количество параметров в коллекции ограничено объемом доступной памяти и не может быть больше значения Int32.MaxValue.
При добавлении параметра в коллекцию его свойства не изменяются.
Синтаксис
public override int Add(Object value);
value
– добавляемый параметр (объект DbParameter
).
Возвращаемое значение
Порядковый номер (значение типа System.Int32) добавленного параметра в коллекции. Отсчет начинается с 0
.
Исключения
ArgumentException | Добавляемый параметр уже существует в коллекции. | |
InvalidCastException | Переданный параметр не является LinterDbParameter. | |
ArgumentNullException | Аргумент value содержит null-значение. | |
OutOfMemoryException ,
OverflowException | Превышено допустимое количество параметров в коллекции (недостаточно ресурсов). |
Пример
// C# using System; using System.Data; using System.Data.Common; class AddSample { static void Main() { // Создание фабрики классов провайдера DbProviderFactory factory = DbProviderFactories.GetFactory("System.Data.LinterClient"); // Создание команды DbCommand myCommand = factory.CreateCommand(); // Создание параметра DbParameter myParam = factory.CreateParameter(); myParam.ParameterName = "MAKE"; myParam.DbType = DbType.String; myParam.Size = 40; // Добавление параметра в коллекцию myCommand.Parameters.Add(myParam); } }