共用方式為


SqlParameterCollection 類別

定義

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

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
type SqlParameterCollection = class
    inherit DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
繼承
SqlParameterCollection
屬性

範例

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

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    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);

    }
}

備註

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

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

屬性

Count

傳回包含 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)

SqlParameter 加入至 SqlParameterCollection (已知參數名稱和資料類型)。

Add(String, SqlDbType, Int32)

SqlParameter 加入至具有指定參數名稱、SqlParameterCollection 和大小的 SqlDbType

Add(String, SqlDbType, Int32, String)

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,從指定的目的索引開始。

GetEnumerator()

傳回在 SqlParameterCollection 中逐一查看的列舉值。

IndexOf(Object)

取得集合中指定的 Object 位置。

IndexOf(SqlParameter)

取得集合中指定的 SqlParameter 位置。

IndexOf(String)

取得集合中具有指定名稱之指定 SqlParameter 的位置。

Insert(Int32, Object)

Object 插入至 SqlParameterCollection 的指定索引處。

Insert(Int32, SqlParameter)

SqlParameter 物件插入 SqlParameterCollection 的指定索引處。

Remove(Object)

從集合移除指定的 SqlParameter

Remove(SqlParameter)

從集合移除指定的 SqlParameter

RemoveAt(Int32)

SqlParameter 的指定索引處移除 SqlParameterCollection

RemoveAt(String)

SqlParameter 的指定參數名稱處移除 SqlParameterCollection

適用於