SqlParameterCollection Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Představuje kolekci parametrů přidružených k SqlCommand a jejich odpovídající mapování na sloupce v objektu DataSet. Tato třída se nemůže 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

Object

MarshalByRefObject

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í DataSet. Tento kód předpokládá, že se DataSet již vytvořilo a má SqlDataAdapter odpovídající schéma, příkazy a připojení.

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

Poznámky

Pokud příkaz obsahuje ad hoc příkaz SQL, na rozdíl od názvu uložené procedury, musí být počet parametrů v kolekci roven počtu zástupných symbolů parametrů v textu příkazu nebo 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 hodnotu než výchozí.

Další informace o dalších vzorových kódech demonstrujících použití parametrů najdete v tématu Příkazy a parametry.

Vlastnosti

Name	Description
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í.
IsSynchronized	Získá hodnotu, která označuje, zda SqlParameterCollection je synchronizován.
Item[Int32]	Získá na zadaném indexu SqlParameter .
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

Name	Description
Add(Object)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(SqlParameter)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(String, Object)	Zastaralé. Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	SqlParameter Přidá do SqlParameterCollection pole s názvem parametru, datovým typem a délkou sloupce.
Add(String, SqlDbType, Int32)	SqlParameter Přidá hodnotu do zadaného SqlParameterCollectionnázvu SqlDbType a velikosti parametru.
Add(String, SqlDbType)	SqlParameter Přidá do SqlParameterCollection daného názvu parametru a datového typu.
AddRange(Array)	Přidá pole hodnot na konec SqlParameterCollection.
AddRange(SqlParameter[])	Přidá pole SqlParameter hodnot na konec SqlParameterCollection.
AddWithValue(String, Object)	Přidá hodnotu na konec SqlParameterCollection.
Clear()	Odebere všechny SqlParameter objekty z objektu SqlParameterCollection.
Contains(Object)	Určuje, zda zadaný Object je v tomto SqlParameterCollection.
Contains(SqlParameter)	Určuje, zda zadaný SqlParameter je v tomto SqlParameterCollection.
Contains(String)	Určuje, zda je zadaný název parametru v tomto SqlParameterCollection.
CopyTo(Array, Int32)	Zkopíruje všechny prvky aktuálního do SqlParameterCollection zadaného jednorozměrného Array indexu počínaje zadaným cílovým Array indexem.
CopyTo(SqlParameter[], Int32)	Zkopíruje všechny prvky aktuálního SqlParameterCollection do zadaného SqlParameterCollection indexu počínaje zadaným cílovým indexem.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí enumerátor, který iteruje přes SqlParameterCollection.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetParameter(Int32)	DbParameter Vrátí objekt v zadaném indexu v kolekci. (Zděděno od DbParameterCollection)
GetParameter(String)	Vrátí DbParameter objekt se zadaným názvem. (Zděděno od DbParameterCollection)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IndexOf(Object)	Získá umístění zadané Object v kolekci.
IndexOf(SqlParameter)	Získá umístění zadané SqlParameter v kolekci.
IndexOf(String)	Získá umístění zadaného SqlParameter s zadaným názvem.
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Insert(Int32, Object)	Vloží do zadaného indexuSqlParameterCollection.Object
Insert(Int32, SqlParameter)	Vloží SqlParameter objekt do zadaného indexu SqlParameterCollection .
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
Remove(Object)	Odebere zadanou SqlParameter položku z kolekce.
Remove(SqlParameter)	Odebere zadanou SqlParameter položku z kolekce.
RemoveAt(Int32)	Odebere SqlParameter ze zadaného indexu SqlParameterCollection .
RemoveAt(String)	Odebere SqlParameter ze zadaného názvu parametru SqlParameterCollection .
SetParameter(Int32, DbParameter)	DbParameter Nastaví objekt v zadaném indexu na novou hodnotu. (Zděděno od DbParameterCollection)
SetParameter(String, DbParameter)	DbParameter Nastaví objekt se zadaným názvem na novou hodnotu. (Zděděno od DbParameterCollection)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
IDataParameterCollection.Item[String]	Získá nebo nastaví parametr v zadaném indexu. (Zděděno od DbParameterCollection)
IList.Item[Int32]	Získá nebo nastaví prvek v zadaném indexu. (Zděděno od DbParameterCollection)

Metody rozšíření

Name	Description
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)	Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.

Viz také

• Příkazy a parametry (ADO.NET)
• Parametry datovéhoadapteru (ADO.NET)
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET