OdbcParameterCollection 類別

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v9.0.0-rc.1.24431.7

來源:

OdbcParameterCollection.cs

表示與 OdbcCommand 相關之參數及其與 DataSet 中資料行之個別對應的集合。 此類別無法獲得繼承。

public ref class OdbcParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class OdbcParameterCollection : System.Data.Common.DbParameterCollection

type OdbcParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class OdbcParameterCollection
Inherits DbParameterCollection

繼承

Object

MarshalByRefObject

DbParameterCollection

OdbcParameterCollection

範例

下列範例假設數據源具有名為 MoneyTable 的數據表，以及名為 MoneyProcedure 的預存程式，其定義如下：

CREATE TABLE MoneyTable (col1 int, col2 smallmoney, col3 decimal);  

CREATE PROC MoneyProcedure (@p1 int, @p2 smallmoney, @p3 decimal)   
AS   
INSERT INTO MyTable VALUES (@p1, @p2, @p3);  

此範例會建立參數並呼叫 MoneyProcedure 預存程式。

public void CreateMyProc(OdbcConnection connection)
{
    OdbcCommand command = connection.CreateCommand();
    command.CommandText = "{ call MyProc(?,?,?) }";

    OdbcParameter param = new OdbcParameter();
    param.DbType = DbType.Int32;
    param.Value = 1;
    command.Parameters.Add(param);

    param = new OdbcParameter();
    param.DbType = DbType.Decimal;
    param.Value = 1;
    command.Parameters.Add(param);

    param = new OdbcParameter();
    param.DbType = DbType.Decimal;
    param.Value = 1;
    command.Parameters.Add(param);

    command.ExecuteNonQuery();
 }

Public Sub CreateMyProc(ByVal connection As OdbcConnection)

  Dim command As OdbcCommand = connection.CreateCommand()
  Command.CommandText = "{ call MyProc(?,?,?) }"

  Dim param As New OdbcParameter()
  param.DbType = DbType.Int32
  param.Value = 1
  command.Parameters.Add(param)

  param = New OdbcParameter()
  param.DbType = DbType.Decimal
  param.Value = 1
  command.Parameters.Add(param)

  param = New OdbcParameter()
  param.DbType = DbType.Decimal
  param.Value = 1
  command.Parameters.Add(param)

  command.ExecuteNonQuery()

End Sub

備註

集合中的參數數目必須等於命令文字中的參數佔位元元數目，否則 .NET Framework Data Provider for ODBC 會引發錯誤。

屬性

Count	傳回包含 OdbcParameterCollection 中之項目數目的整數。 唯讀。
IsFixedSize	取得值，指出 OdbcParameterCollection 是否有固定的大小。 唯讀。
IsReadOnly	取得值，這個值表示 OdbcParameterCollection 是否為唯讀。
IsSynchronized	取得值，表示 OdbcParameterCollection 是否同步處理。 唯讀。
Item[Int32]	取得或設定在指定索引處的 OdbcParameter。
Item[String]	取得或設定具有指定之名稱的 OdbcParameter。
SyncRoot	取得可用以同步存取 OdbcParameterCollection 的物件。 唯讀。

方法

Add(Object)	將指定的 OdbcParameter 物件加入至 OdbcParameterCollection。
Add(OdbcParameter)	將指定的 OdbcParameter 加入至 OdbcParameterCollection。
Add(String, Object)	已淘汰. 加入 OdbcParameter 至提供參數名稱和值的 OdbcParameterCollection。
Add(String, OdbcType)	在提供參數名稱和資料型別的情況下，將 OdbcParameter 加入至 OdbcParameterCollection。
Add(String, OdbcType, Int32)	將 OdbcParameter 加入至 OdbcParameterCollection，並提供參數名稱、資料型別和資料行長度。
Add(String, OdbcType, Int32, String)	將 OdbcParameter 加入至提供參數名稱、資料型別、資料行長度和來源資料行名稱的 OdbcParameterCollection。
AddRange(Array)	將值陣列加入至 OdbcParameterCollection 結尾。
AddRange(OdbcParameter[])	將 OdbcParameter 值陣列加入至 OdbcParameterCollection 結尾。
AddWithValue(String, Object)	將值加入至 OdbcParameterCollection 結尾。
Clear()	從 OdbcParameter 移除所有 OdbcParameterCollection 物件。
Contains(Object)	判斷指定的 Object 是否在這個 OdbcParameterCollection 中。
Contains(OdbcParameter)	判斷指定的 OdbcParameter 是否在這個 OdbcParameterCollection 中。
Contains(String)	取得值，指出具有指定參數名稱的 OdbcParameter 是否存在於集合中。
CopyTo(Array, Int32)	將目前 OdbcParameterCollection 的所有項目複製到指定的一維 Array，從指定的目的 Array 索引開始。
CopyTo(OdbcParameter[], Int32)	將目前 OdbcParameterCollection 的所有項目複製到指定的 OdbcParameterCollection，從指定的目的索引開始。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回在 OdbcParameterCollection 中逐一查看的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetParameter(Int32)	傳回位於此集合指定索引處的 DbParameter 物件。 (繼承來源 DbParameterCollection)
GetParameter(String)	傳回具有指定名稱的 DbParameter 物件。 (繼承來源 DbParameterCollection)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(Object)	取得集合中指定的 Object 位置。
IndexOf(OdbcParameter)	取得集合中指定的 OdbcParameter 位置。
IndexOf(String)	取得集合中具有指定名稱之指定 OdbcParameter 的位置。
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
Insert(Int32, Object)	將 Object 插入 OdbcParameterCollection中指定的索引處。
Insert(Int32, OdbcParameter)	將 OdbcParameter 物件插入 OdbcParameterCollection 的指定索引處。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
Remove(Object)	從 Object 移除 OdbcParameterCollection 物件。
Remove(OdbcParameter)	從 OdbcParameter 中移除 OdbcParameterCollection。
RemoveAt(Int32)	從 OdbcParameter 的指定索引處移除 OdbcParameterCollection。
RemoveAt(String)	從 OdbcParameter 移除指定之參數名稱的 OdbcParameterCollection。
SetParameter(Int32, DbParameter)	將指定索引處的 DbParameter 物件設定為新值。 (繼承來源 DbParameterCollection)
SetParameter(String, DbParameter)	將具有指定名稱的 DbParameter 物件設定為新值。 (繼承來源 DbParameterCollection)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IDataParameterCollection.Item[String]	在指定索引位置上取得或設定參數。 (繼承來源 DbParameterCollection)
IList.Add(Object)	如需這個成員的說明，請參閱 Add(Object)。 (繼承來源 DbParameterCollection)
IList.Contains(Object)	如需這個成員的說明，請參閱 Contains(Object)。 (繼承來源 DbParameterCollection)
IList.IndexOf(Object)	如需這個成員的說明，請參閱 IndexOf(Object)。 (繼承來源 DbParameterCollection)
IList.Insert(Int32, Object)	如需這個成員的說明，請參閱 Insert(Int32, Object)。 (繼承來源 DbParameterCollection)
IList.Item[Int32]	在指定的索引位置上取得或設定項目。 (繼承來源 DbParameterCollection)
IList.Remove(Object)	如需這個成員的說明，請參閱 Remove(Object)。 (繼承來源 DbParameterCollection)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

另請參閱

• 使用命令
• 搭配 DataAdapter 使用參數