OdbcParameterCollection.Add Метод

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v9.0.0-preview.6.24327.7

Добавляет OdbcParameter к OdbcParameterCollection.

Перегрузки

Add(OdbcParameter)	Добавляет заданный объект OdbcParameter в OdbcParameterCollection.
Add(Object)	Добавляет указанный объект OdbcParameter к объекту OdbcParameterCollection.
Add(String, OdbcType)	Добавляет OdbcParameter с заданным именем параметра и типом данных в коллекцию OdbcParameterCollection.
Add(String, Object)	Устаревшие.. Добавляет объект OdbcParameter с заданным именем параметра и значением в OdbcParameterCollection.
Add(String, OdbcType, Int32)	Добавляет OdbcParameter с заданным именем, типом данных и длиной столбца в OdbcParameterCollection.
Add(String, OdbcType, Int32, String)	Добавляет объект OdbcParameter с заданным именем параметра, типом данных, длиной столбца и именем столбца источника в OdbcParameterCollection.

Add(OdbcParameter)

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

OdbcParameterCollection.cs

Добавляет заданный объект OdbcParameter в OdbcParameterCollection.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::Data::Odbc::OdbcParameter ^ value);

public System.Data.Odbc.OdbcParameter Add (System.Data.Odbc.OdbcParameter value);

override this.Add : System.Data.Odbc.OdbcParameter -> System.Data.Odbc.OdbcParameter

Public Function Add (value As OdbcParameter) As OdbcParameter

Параметры

value

OdbcParameter

Параметр OdbcParameter для добавления в коллекцию.

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

OdbcParameter

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

Исключения

ArgumentException

OdbcParameter, заданный в параметре value, уже добавлен в эту или другую коллекцию OdbcParameterCollection.

ArgumentNullException

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

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

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

Add(Object)

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

OdbcParameterCollectionHelper.cs

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

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

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

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

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

Add(String, OdbcType)

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

OdbcParameterCollection.cs

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

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType);

override this.Add : string * System.Data.Odbc.OdbcType -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType) As OdbcParameter

Параметры

parameterName

String

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

odbcType

OdbcType

Одно из значений перечисления OdbcType.

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

OdbcParameter

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

Примеры

В следующем примере добавляется в OdbcParameter коллекцию Parameters .

public void CreateParamCollection()
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    object paramObject = new OdbcParameter(
        "CustomerID", OdbcType.VarChar);
    int paramIndex = paramCollection.Add(paramObject);
}

Public Sub CreateParamCollection(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = command.Parameters
  Dim paramObject As Object = New OdbcParameter( _
    "CustomerID", OdbcType.VarChar)
  Dim paramIndex As Integer = paramCollection.Add(paramObject)
End Sub

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

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

Add(String, Object)

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

OdbcParameterCollection.cs

Внимание!

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

Добавляет объект OdbcParameter с заданным именем параметра и значением в OdbcParameterCollection.

public:
 System::Data::Odbc::OdbcParameter ^ 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.Odbc.OdbcParameter 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.Odbc.OdbcParameter

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

Параметры

parameterName

String

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

value

Object

Value из OdbcParameter для добавления в коллекцию.

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

OdbcParameter

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

Атрибуты

ObsoleteAttribute

Исключения

InvalidCastException

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

Комментарии

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

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

Если это преобразование не выполняется, компилятор предполагает, что вы пытаетесь вызвать перегрузку OdbcParameterCollection.Add .

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

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

Add(String, OdbcType, Int32)

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

OdbcParameterCollection.cs

Добавляет OdbcParameter с заданным именем, типом данных и длиной столбца в OdbcParameterCollection.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType, int size);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType, int size);

override this.Add : string * System.Data.Odbc.OdbcType * int -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType, size As Integer) As OdbcParameter

Параметры

parameterName

String

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

odbcType

OdbcType

Одно из значений перечисления OdbcType.

size

Int32

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

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

OdbcParameter

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

Примеры

В следующем примере добавляется в OdbcParameter коллекцию OdbcCommand.Parameters .

public void CreateOdbcParamColl(OdbcConnection connection)
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    OdbcParameter parameter = paramCollection.Add(
        "CustomerID", OdbcType.VarChar, 5);
}

Public Sub CreateOdbcParamColl(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = _
    command.Parameters
  Dim parameter As OdbcParameter = _
    paramCollection.Add("CustomerID", OdbcType.VarChar, 5)
End Sub

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

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

Add(String, OdbcType, Int32, String)

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

OdbcParameterCollection.cs

Добавляет объект OdbcParameter с заданным именем параметра, типом данных, длиной столбца и именем столбца источника в OdbcParameterCollection.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType, int size, System::String ^ sourceColumn);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType, int size, string? sourceColumn);

override this.Add : string * System.Data.Odbc.OdbcType * int * string -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType, size As Integer, sourceColumn As String) As OdbcParameter

Параметры

parameterName

String

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

odbcType

OdbcType

Одно из значений перечисления OdbcType.

size

Int32

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

sourceColumn

String

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

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

OdbcParameter

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

Примеры

В следующем примере добавляется в OdbcParameter коллекцию Parameters .

public void CreateParameterCollection(OdbcConnection connection)
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    OdbcParameter parameter = paramCollection.Add(
        "CustomerID", OdbcType.VarChar, 5, "CustomerID");
}

Public Sub CreateParameterCollection(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = command.Parameters
  Dim parameter As OdbcParameter = paramCollection.Add( _
    "CustomerID", OdbcType.VarChar, 5, "CustomerID")
End Sub

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

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