OleDbParameterCollection.Add Метод

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v11.0.0-preview.4.26230.115

Добавляется OleDbParameter в OleDbParameterCollectionобъект .

Перегрузки

Имя	Описание
Add(OleDbParameter)	Добавляет указанный OleDbParameter в OleDbParameterCollection.
Add(Object)	Добавляет указанный OleDbParameter объект в OleDbParameterCollectionобъект .
Add(String, OleDbType)	Добавляется в OleDbParameterOleDbParameterCollectionпараметр с именем параметра и типом данных.
Add(String, Object)	Устаревшие.. Добавляет к OleDbParameter заданному OleDbParameterCollection имени и значению параметра.
Add(String, OleDbType, Int32)	Добавляет значение OleDbParameter к заданному OleDbParameterCollection имени параметра, типу данных и длине столбца.
Add(String, OleDbType, Int32, String)	OleDbParameter Добавляет имя OleDbParameterCollection параметра, тип данных, длину столбца и имя исходного столбца.

Add(OleDbParameter)

Исходный код:

OleDbParameterCollection.cs

Добавляет указанный OleDbParameter в OleDbParameterCollection.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::Data::OleDb::OleDbParameter ^ value);

public System.Data.OleDb.OleDbParameter Add(System.Data.OleDb.OleDbParameter value);

override this.Add : System.Data.OleDb.OleDbParameter -> System.Data.OleDb.OleDbParameter

Public Function Add (value As OleDbParameter) As OleDbParameter

Параметры

value

OleDbParameter

Добавление OleDbParameter в коллекцию.

Возвращаемое значение

OleDbParameter

Индекс нового OleDbParameter объекта.

Исключения

ArgumentException

Указанный OleDbParameter в параметре value уже добавлен в этот или другой OleDbParameterCollectionпараметр.

ArgumentNullException

Параметр value имеет значение NULL.

Примеры

В следующем примере создается OleDbParameterCollection и добавляется OleDbParameter.

public void CreateParameters()
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        new OleDbParameter("CustomerID", OleDbType.VarChar));
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    New OleDbParameter("CustomerID", OleDbType.VarChar))
End Sub

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter

Add(Object)

Исходный код:

OleDbParameterCollectionHelper.cs

Добавляет указанный OleDbParameter объект в OleDbParameterCollectionобъект .

public:
 override int Add(System::Object ^ value);

public override int Add(object value);

override this.Add : obj -> int

Public Overrides Function Add (value As Object) As Integer

Параметры

value

Object

А Object.

Возвращаемое значение

Int32

Индекс нового OleDbParameter объекта в коллекции.

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter

Add(String, OleDbType)

Исходный код:

OleDbParameterCollection.cs

Добавляется в OleDbParameterOleDbParameterCollectionпараметр с именем параметра и типом данных.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType);

public System.Data.OleDb.OleDbParameter Add(string? parameterName, System.Data.OleDb.OleDbType oleDbType);

override this.Add : string * System.Data.OleDb.OleDbType -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType) As OleDbParameter

Параметры

parameterName

String

Имя параметра.

oleDbType

OleDbType

Одно из значений OleDbType .

Возвращаемое значение

OleDbParameter

Индекс нового OleDbParameter объекта.

Примеры

В следующем примере создается OleDbParameterCollection и добавляется OleDbParameter.

public void CreateParameters()
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        "CustomerID", OleDbType.VarChar);
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar)
End Sub

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter

Add(String, Object)

Исходный код:

OleDbParameterCollection.cs

Внимание

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.

Добавляет к OleDbParameter заданному OleDbParameterCollection имени и значению параметра.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Object ^ value);

[System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.")]
public System.Data.OleDb.OleDbParameter Add(string? parameterName, object? value);

[<System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.")>]
override this.Add : string * obj -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, value As Object) As OleDbParameter

Параметры

parameterName

String

Имя параметра.

value

Object

Value ОбъектOleDbParameter, добавляемый в коллекцию.

Возвращаемое значение

OleDbParameter

Индекс нового OleDbParameter объекта.

Атрибуты

ObsoleteAttribute

Исключения

InvalidCastException

Параметр value не OleDbParameterявляется .

Комментарии

Используйте осторожность при использовании этой перегрузки Add метода, чтобы указать значения целочисленных параметров. Так как эта перегрузка принимает value тип Object, необходимо преобразовать значение Object в тип, если значение равно нулю. Если вы не выполняете это преобразование, компилятор предполагает, что вы пытаетесь вызвать перегрузку Add .

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter

Add(String, OleDbType, Int32)

Исходный код:

OleDbParameterCollection.cs

Добавляет значение OleDbParameter к заданному OleDbParameterCollection имени параметра, типу данных и длине столбца.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size);

public System.Data.OleDb.OleDbParameter Add(string? parameterName, System.Data.OleDb.OleDbType oleDbType, int size);

override this.Add : string * System.Data.OleDb.OleDbType * int -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer) As OleDbParameter

Параметры

parameterName

String

Имя параметра.

oleDbType

OleDbType

Одно из значений OleDbType .

size

Int32

Длина столбца.

Возвращаемое значение

OleDbParameter

Индекс нового OleDbParameter объекта.

Примеры

В следующем примере создается OleDbParameterCollectionэкземпляр коллекции, добавляется экземпляр OleDbParameter в коллекцию и возвращается ссылка на новую OleDbParameter.

public void CreateParameters(OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5);
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5)
End Sub

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter

Add(String, OleDbType, Int32, String)

Исходный код:

OleDbParameterCollection.cs

OleDbParameter Добавляет имя OleDbParameterCollection параметра, тип данных, длину столбца и имя исходного столбца.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size, System::String ^ sourceColumn);

public System.Data.OleDb.OleDbParameter Add(string? parameterName, System.Data.OleDb.OleDbType oleDbType, int size, string? sourceColumn);

override this.Add : string * System.Data.OleDb.OleDbType * int * string -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer, sourceColumn As String) As OleDbParameter

Параметры

parameterName

String

Имя параметра.

oleDbType

OleDbType

Одно из значений OleDbType .

size

Int32

Длина столбца.

sourceColumn

String

Имя исходного столбца.

Возвращаемое значение

OleDbParameter

Индекс нового OleDbParameter объекта.

Примеры

В следующем примере создается OleDbParameterCollectionэкземпляр коллекции, добавляется экземпляр OleDbParameter в коллекцию и возвращается ссылка на новую OleDbParameter.

public void CreateParameters(OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5, "CustomerID");
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5, "CustomerID")
End Sub

См. также раздел

• Работа с командами
• Использование параметров с DataAdapter