SqlParameterCollection 類別

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表一組與相關 SqlCommand 聯的參數及其對 DataSet應到欄位的映射。此類別無法獲得繼承。

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

繼承: Object

MarshalByRefObject
SqlParameterCollection

繼承: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

屬性: ListBindableAttribute

實作: ICollection IEnumerable IList IDataParameterCollection

範例

以下範例透過集合建立多個實SqlParameter SqlParameterCollection例。這些參數用於選擇資料來源中的資料並填充 DataSet。此程式碼假設 a DataSet 與 a 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 會產生錯誤。使用儲存程序時，必須提供該程序中宣告的所有參數（不含預設值）。以預設值宣告的參數為可選。這讓你可以指定一個非預設值的值。

欲了解更多說明如何使用參數的範例程式碼，請參閱指令與參數。

屬性

名稱	Description
Count	回傳一個整數，包含中 SqlParameterCollection元素的數量。唯讀。
IsFixedSize	會得到一個表示是否 SqlParameterCollection 固定大小的值。
IsReadOnly	會得到一個值，表示是否 SqlParameterCollection 為唯讀。
IsSynchronized	會得到一個表示是否 SqlParameterCollection 同步的值。
Item[Int32]	在指定的索引處得到。SqlParameter
Item[String]	得到指定名稱的。SqlParameter
SyncRoot	取得一個物件，可用來同步存取 SqlParameterCollection。

方法

名稱	Description
Add(Object)	將指定的 SqlParameter 物件 SqlParameterCollection加入。
Add(SqlParameter)	將指定的 SqlParameter 物件 SqlParameterCollection加入。
Add(String, Object)	已淘汰. 將指定的 SqlParameter 物件 SqlParameterCollection加入。
Add(String, SqlDbType, Int32, String)	在中SqlParameterCollection加入 aSqlParameter，並包含參數名稱、資料型態和欄位長度。
Add(String, SqlDbType, Int32)	在指定參數名稱SqlDbType和大小下，將 a SqlParameter 加到 SqlParameterCollection。
Add(String, SqlDbType)	在給定的參數名稱和資料型態中加入 a SqlParameter SqlParameterCollection 。
AddRange(Array)	在的末尾 SqlParameterCollection加上一組數值。
AddRange(SqlParameter[])	在的末尾SqlParameter加上一組SqlParameterCollection數值。
AddWithValue(String, Object)	會為的末尾 SqlParameterCollection加上一個值。
Clear()	移除所有SqlParameter物件。SqlParameterCollection
Contains(Object)	判斷指定的 Object 是否在此 SqlParameterCollection中。
Contains(SqlParameter)	判斷指定的 SqlParameter 是否在此 SqlParameterCollection中。
Contains(String)	判斷指定的參數名稱是否屬於此 SqlParameterCollection。
CopyTo(Array, Int32)	將所有電流SqlParameterCollection元素從指定的目的Array索引起點複製到指定的一維Array。
CopyTo(SqlParameter[], Int32)	從指定的目的索引開始，將所有電流 SqlParameterCollection 元素複製到指定的 SqlParameterCollection 索引。
CreateObjRef(Type)	建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。 (繼承來源 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)	在指定索引處移除。SqlParameter SqlParameterCollection
RemoveAt(String)	在指定的參數名稱處移除。SqlParameter SqlParameterCollection
SetParameter(Int32, DbParameter)	將指定索引的物件設定 DbParameter 為新值。 (繼承來源 DbParameterCollection)
SetParameter(String, DbParameter)	將指定名稱的物件設定 DbParameter 為新值。 (繼承來源 DbParameterCollection)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)

明確介面實作

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

擴充方法

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

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？