OleDbParameterCollection.Add Метод

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v9.0.0-preview.3.24172.9

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

Перегрузки

Add(OleDbParameter)	Добавляет заданный объект OleDbParameter в OleDbParameterCollection.
Add(Object)	Добавляет указанный объект OleDbParameter к объекту OleDbParameterCollection.
Add(String, OleDbType)	Добавляет OleDbParameter с заданным именем параметра и типом данных в коллекцию OleDbParameterCollection.
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

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

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 тип, если значение равно нулю, как показано в следующем примере C#.

parameters.Add("@pname", Convert.ToInt32(0));  

Если вы не выполните это преобразование, компилятор предполагает, что вы пытаетесь вызвать перегрузку 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