OleDbParameterCollection 類別

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v8.0.0

來源:

OleDbParameterCollection.cs

表示與 OleDbCommand 相關之參數及其與 DataSet 中資料行之個別對應的集合。

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

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

type OleDbParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection

繼承

Object

DbParameterCollection

OleDbParameterCollection

範例

下列範例會在 內透過 OleDbParameterCollection 集合建立的OleDbDataAdapter多個實例OleDbParameter。 這些參數可用來選取數據源中的數據，並將數據 DataSet放在 中。 這個範例假設 DataSet 已使用適當的架構、命令和連線來建立 和 OleDbDataAdapter 。

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

備註

集合中的參數數目必須等於命令文字中的參數佔位元元數目，否則 OLE DB 的數據提供者 .NET Framework 可能會引發錯誤。

屬性

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

方法

Add(Object)	將指定的 OleDbParameter 物件加入至 OleDbParameterCollection。
Add(OleDbParameter)	將指定的 OleDbParameter 加入至 OleDbParameterCollection。
Add(String, Object)	已淘汰. 加入 OleDbParameter 至提供參數名稱和值的 OleDbParameterCollection。
Add(String, OleDbType)	在提供參數名稱和資料型別的情況下，將 OleDbParameter 加入至 OleDbParameterCollection。
Add(String, OleDbType, Int32)	將 OleDbParameter 加入至提供參數名稱、資料型別和資料行長度的 OleDbParameterCollection。
Add(String, OleDbType, Int32, String)	將 OleDbParameter 加入至提供參數名稱、資料型別、資料行長度和來源資料行名稱的 OleDbParameterCollection。
AddRange(Array)	將值陣列加入至 OleDbParameterCollection 結尾。
AddRange(OleDbParameter[])	將 OleDbParameter 值陣列加入至 OleDbParameterCollection 結尾。
AddWithValue(String, Object)	將值加入至 OleDbParameterCollection 結尾。
Clear()	從 OleDbParameter 移除所有 OleDbParameterCollection 物件。
Contains(Object)	判斷指定的 Object 是否在這個 OleDbParameterCollection 中。
Contains(OleDbParameter)	判斷指定的 OleDbParameter 是否在這個 OleDbParameterCollection 中。
Contains(String)	判斷指定的 String 是否在這個 OleDbParameterCollection 中。
CopyTo(Array, Int32)	將目前 OleDbParameterCollection 的所有項目複製到指定的一維 Array，從指定的目的 Array 索引開始。
CopyTo(OleDbParameter[], Int32)	將目前 OleDbParameterCollection 的所有項目複製到指定的 OleDbParameterCollection，從指定的目的索引開始。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回在 OleDbParameterCollection 中逐一查看的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetParameter(Int32)	傳回位於此集合指定索引處的 DbParameter 物件。 (繼承來源 DbParameterCollection)
GetParameter(String)	傳回具有指定名稱的 DbParameter 物件。 (繼承來源 DbParameterCollection)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(Object)	集合中指定之 Object 的位置。
IndexOf(OleDbParameter)	取得集合中指定的 OleDbParameter 位置。
IndexOf(String)	取得集合中具有指定名稱之指定 OleDbParameter 的位置。
Insert(Int32, Object)	將 Object 插入 OleDbParameterCollection中指定的索引處。
Insert(Int32, OleDbParameter)	將 OleDbParameter 物件插入 OleDbParameterCollection 的指定索引處。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(Object)	從 Object 移除 OleDbParameterCollection 物件。
Remove(OleDbParameter)	從 OleDbParameter 中移除 OleDbParameterCollection。
RemoveAt(Int32)	從 OleDbParameter 的指定索引處移除 OleDbParameterCollection。
RemoveAt(String)	從 OleDbParameter 的指定參數名稱處移除 OleDbParameterCollection。
SetParameter(Int32, DbParameter)	將指定索引處的 DbParameter 物件設定為新值。 (繼承來源 DbParameterCollection)
SetParameter(String, DbParameter)	將具有指定名稱的 DbParameter 物件設定為新值。 (繼承來源 DbParameterCollection)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

擴充方法

另請參閱

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