SqlParameterCollection Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Představuje kolekci parametrů přidružených k objektu SqlCommand a jejich příslušným mapováním na sloupce v objektu DataSet. Tuto třídu nelze dědit.

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

Dědičnost

DbParameterCollection

SqlParameterCollection

Atributy

ListBindableAttribute

Příklady

Následující příklad vytvoří více instancí SqlParameter prostřednictvím SqlParameterCollection kolekce. Parametry slouží k výběru dat ve zdroji dat a naplnění objektu DataSet. Tento kód předpokládá, že DataSet objekty a a SqlDataAdapter již byly vytvořeny s příslušným schématem, příkazy a připojením.

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

    }
}

Poznámky

Pokud příkaz obsahuje příkaz SQL ad hoc, na rozdíl od názvu uložené procedury, musí se počet parametrů v kolekci rovnat počtu zástupných symbolů parametrů v textu příkazu, jinak SQL Server vyvolá chybu. U uložené procedury musí být zadané všechny parametry deklarované v uložené proceduře bez výchozí hodnoty. Parametry deklarované s výchozí hodnotou jsou volitelné. To vám umožní zadat jinou než výchozí hodnotu.

Další informace s dalším ukázkovým kódem demonstrujícím, jak používat parametry, najdete v tématu Příkazy a parametry.

Vlastnosti

Count	Vrátí celé číslo, které obsahuje počet prvků v objektu SqlParameterCollection. Jen pro čtení.
IsFixedSize	Získá hodnotu, která označuje, zda SqlParameterCollection má pevnou velikost.
IsReadOnly	Získá hodnotu, která označuje, zda SqlParameterCollection je jen pro čtení.
Item[Int32]	Získá hodnotu SqlParameter v zadaném indexu.
Item[String]	Získá se SqlParameter zadaným názvem.
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k SqlParameterCollection.

Metody

Add(Object)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(SqlParameter)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(String, SqlDbType)	Přidá parametr SqlParameter k zadanému SqlParameterCollection názvu parametru a datovému typu.
Add(String, SqlDbType, Int32)	Přidá do parametru SqlParameterSqlParameterCollection, a to s ohledem na zadaný název SqlDbType parametru a velikost.
Add(String, SqlDbType, Int32, String)	Přidá do SqlParameter parametru SqlParameterCollection s názvem parametru, datovým typem a délkou sloupce.
AddRange(Array)	Přidá pole hodnot na konec objektu SqlParameterCollection.
AddRange(SqlParameter[])	Přidá pole SqlParameter hodnot na konec objektu SqlParameterCollection.
AddWithValue(String, Object)	Přidá hodnotu na konec .SqlParameterCollection
Clear()	Odebere SqlParameter všechny objekty z objektu SqlParameterCollection.
Contains(Object)	Určuje, zda je zadaný Object parametr v tomto SqlParameterCollectionparametru .
Contains(SqlParameter)	Určuje, zda je zadaný SqlParameter parametr v tomto SqlParameterCollectionparametru .
Contains(String)	Určuje, zda je zadaný název parametru v tomto SqlParameterCollectionparametru .
CopyTo(Array, Int32)	Zkopíruje všechny prvky proudu SqlParameterCollection do zadaného jednorozměrného Array indexu počínaje zadaným cílovým Array indexem.
CopyTo(SqlParameter[], Int32)	Zkopíruje všechny prvky proudu SqlParameterCollection do zadaného SqlParameterCollection od zadaného cílového indexu.
GetEnumerator()	Vrátí enumerátor, který iteruje přes SqlParameterCollection.
IndexOf(Object)	Získá umístění zadané Object v rámci kolekce.
IndexOf(SqlParameter)	Získá umístění zadané SqlParameter v rámci kolekce.
IndexOf(String)	Získá umístění zadaného SqlParameter se zadaným názvem.
Insert(Int32, Object)	Vloží objekt Object do zadaného SqlParameterCollection indexu.
Insert(Int32, SqlParameter)	SqlParameter Vloží objekt do zadaného SqlParameterCollection indexu.
Remove(Object)	Odebere zadaný SqlParameter objekt z kolekce.
Remove(SqlParameter)	Odebere zadaný SqlParameter objekt z kolekce.
RemoveAt(Int32)	Odebere hodnotu SqlParameter z zadaného SqlParameterCollection indexu.
RemoveAt(String)	Odebere parametr SqlParameter ze zadaného SqlParameterCollection názvu parametru.