OdbcParameterCollection.Add 方法

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v8.0.0

將 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

value 參數中指定的 OdbcParameter 已經加入至這個或另一個 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

要加入集合之 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)

來源:

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 使用參數