SqlParameterCollection 類別

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

表示與 SqlCommand 相關聯的參數集合，以及它們與 DataSet中的數據行對應。 無法繼承這個類別。

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

繼承

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

屬性

ListBindableAttribute

範例

下列範例會透過 SqlParameterCollection 集合建立多個 SqlParameter 實例。 參數可用來選取數據源中的數據，並填入 DataSet。 此程式代碼假設已使用適當的架構、命令和連線來建立 DataSet 和 SqlDataAdapter。

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

備註

如果命令包含臨機操作 SQL 語句，而不是預存程式名稱，集合中的參數數目必須等於命令文字中的參數位元元數目，或 SQL Server 引發錯誤。 使用預存程式時，必須提供預存程式中宣告且不含預設值的所有參數。 使用預設值宣告的參數是選擇性的。 這可讓您指定預設值以外的值。

如需示範如何使用參數的其他範例程式代碼的詳細資訊，請參閱 命令和參數。

屬性

Count	傳回 Integer，其中包含 SqlParameterCollection中的項目數。 唯讀的。
IsFixedSize	取得值，這個值表示 SqlParameterCollection 是否有固定大小。
IsReadOnly	取得值，這個值表示 SqlParameterCollection 是否為唯讀。
IsSynchronized	取得值，這個值表示是否同步處理 SqlParameterCollection。
Item[Int32]	取得指定索引處的 SqlParameter。
Item[String]	取得具有指定名稱的 SqlParameter。
SyncRoot	取得對象，這個物件可用來同步存取 SqlParameterCollection。

方法

Add(Object)	將指定的 SqlParameter 物件加入至 SqlParameterCollection。
Add(SqlParameter)	將指定的 SqlParameter 物件加入至 SqlParameterCollection。
Add(String, Object)	已淘汰. 將指定的 SqlParameter 物件加入至 SqlParameterCollection。
Add(String, SqlDbType, Int32, String)	使用參數名稱、數據類型和數據行長度，將 SqlParameter 加入至 SqlParameterCollection。
Add(String, SqlDbType, Int32)	指定指定的參數名稱、SqlDbType 和大小，將 SqlParameter 加入 SqlParameterCollection。
Add(String, SqlDbType)	將 SqlParameter 新增至指定參數名稱和數據類型的 SqlParameterCollection。
AddRange(Array)	將值的陣列加入 SqlParameterCollection結尾。
AddRange(SqlParameter[])	將 SqlParameter 值的陣列加入 SqlParameterCollection結尾。
AddWithValue(String, Object)	將值新增至 SqlParameterCollection結尾。
Clear()	從 SqlParameterCollection移除所有 SqlParameter 物件。
Contains(Object)	判斷指定的 Object 是否在此 SqlParameterCollection中。
Contains(SqlParameter)	判斷指定的 SqlParameter 是否在此 SqlParameterCollection中。
Contains(String)	判斷指定的參數名稱是否在此 SqlParameterCollection中。
CopyTo(Array, Int32)	從指定的目的地 Array 索引開始，將目前 SqlParameterCollection 的所有專案複製到指定的一維 Array。
CopyTo(SqlParameter[], Int32)	從指定的目的地索引開始，將目前 SqlParameterCollection 的所有專案複製到指定的 SqlParameterCollection。
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回逐一查看 SqlParameterCollection的列舉值。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetParameter(Int32)	傳回集合中指定索引處的 DbParameter 物件。 (繼承來源 DbParameterCollection)
GetParameter(String)	傳回 DbParameter 具有指定名稱的物件。 (繼承來源 DbParameterCollection)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
IndexOf(Object)	取得集合中指定之 Object 的位置。
IndexOf(SqlParameter)	取得集合中指定之 SqlParameter 的位置。
IndexOf(String)	取得具有指定名稱之指定 SqlParameter 的位置。
InitializeLifetimeService()	取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
Insert(Int32, Object)	將 Object 插入指定索引處的 SqlParameterCollection。
Insert(Int32, SqlParameter)	將 SqlParameter 物件插入指定索引處的 SqlParameterCollection。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
Remove(Object)	從集合中移除指定的 SqlParameter。
Remove(SqlParameter)	從集合中移除指定的 SqlParameter。
RemoveAt(Int32)	從指定索引處的 SqlParameterCollection 中移除 SqlParameter。
RemoveAt(String)	從指定參數名稱的 SqlParameterCollection 中移除 SqlParameter。
SetParameter(Int32, DbParameter)	將位於指定索引處的 DbParameter 物件設定為新的值。 (繼承來源 DbParameterCollection)
SetParameter(String, DbParameter)	將具有指定名稱的 DbParameter 物件設定為新的值。 (繼承來源 DbParameterCollection)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

明確介面實作

IDataParameterCollection.Item[String]	取得或設定位於指定索引處的參數。 (繼承來源 DbParameterCollection)
IList.Item[Int32]	取得或設定位於指定索引處的專案。 (繼承來源 DbParameterCollection)

擴充方法

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

另請參閱

• 命令和參數 （ADO.NET）
• DataAdapter 參數 （ADO.NET）
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀