Insert
Метод вставляет указанный параметр в коллекцию параметров на заданную позицию (освобождая, при необходимости, место путем сдвига существующих параметров).
Синтаксис
public override void Insert(int index, object obj);
index – порядковый номер вставляемого в коллекцию параметра.
Отсчет начинается с 0. Если необходимо добавить параметр в конец коллекции, то нужно указать порядковый номер, равный количеству параметров в коллекции. Например, если в коллекции 10 параметров, то для добавления параметра в конец коллекции (на 11-ю позицию) нужно указать порядковый номер 10.
obj – значение System.Object вставляемого параметра.
Возвращаемое значение
Значение типа void.
Исключения
InvalidCastException
| Тип данных добавляемого объекта не DbParameter. | |
ArgumentOutOfRangeException
| Порядковый номер вставляемого параметра меньше нуля или больше количества параметров в коллекции. |
Пример
// C#
using System;
using System.Data;
using System.Data.Common;
class InsertSample
{
static void Main()
{
// Создание фабрики классов провайдера
DbProviderFactory factory =
DbProviderFactories.GetFactory("System.Data.LinterClient");
// Создание команды
DbCommand cmd = factory.CreateCommand();
// Создание параметров
DbParameter prm1 = factory.CreateParameter();
prm1.ParameterName = "MAKE";
prm1.DbType = DbType.String;
prm1.Size = 40;
cmd.Parameters.Add(prm1);
DbParameter prm2 = factory.CreateParameter();
prm2.ParameterName = "";
prm2.DbType = DbType.String;
prm2.Size = 40;
cmd.Parameters.Add(prm2);
// Создание параметра для вставки
DbParameter prm3 = factory.CreateParameter();
prm3.ParameterName = "YEAR";
prm3.DbType = DbType.Int32;
// Вставка параметра
cmd.Parameters.Insert(1, prm3);
// Освобождение ресурсов
cmd.Dispose();
}
}