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