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)

Source:

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

在 value 参数中指定的 OdbcParameter 已经添加到这个或其他 OdbcParameterCollection 中。

ArgumentNullException

value 参数为 null。

另请参阅

• 使用命令
• 对 DataAdapter 使用参数

Add(Object)

Source:

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)

Source:

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)

Source:

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

要添加到集合中的 OdbcParameter 的 Value。

返回

OdbcParameter

新的 OdbcParameter 对象的索引。

属性

ObsoleteAttribute

例外

InvalidCastException

value 参数不是一个 OdbcParameter。

注解

使用此方法重 Add 载指定整数参数值时，请谨慎。 由于此重载采用 value 类型的 Object，因此，当值为 Object 零时，必须将整数值转换为类型，如以下 C# 示例所示。

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

如果不执行此转换，编译器将假定你正在尝试调用 OdbcParameterCollection.Add 重载。

另请参阅

• 使用命令
• 对 DataAdapter 使用参数

Add(String, OdbcType, Int32)

Source:

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)

Source:

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 使用参数