SqlParameterCollection Třída

Definice

Obor názvů:: System.Data.SqlClient

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Zdroj:: System.Data.SqlClient.notsupported.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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.

Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

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

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

public sealed class SqlParameterCollection : 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

type SqlParameterCollection = class
    inherit 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 DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Dědičnost: Object

DbParameterCollection
SqlParameterCollection

Dědičnost: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Dědičnost: Object

MarshalByRefObject
SqlParameterCollection

Atributy: ListBindableAttribute

Implementuje: ICollection IEnumerable IList IDataParameterCollection

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

Název	Description
Count	Vrátí celé číslo, které obsahuje počet prvků v objektu SqlParameterCollection. Read-only. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IsFixedSize	Získá hodnotu, která označuje, zda SqlParameterCollection má pevnou velikost. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IsReadOnly	Získá hodnotu, která označuje, zda SqlParameterCollection je jen pro čtení. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IsSynchronized	Získá hodnotu, která označuje, zda SqlParameterCollection je synchronizován. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Item[Int32]	Získá na zadaném indexu SqlParameter . Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Item[String]	Získá se SqlParameter zadaným názvem. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Metody

Název	Description
Add(Object)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Add(SqlParameter)	Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Add(String, Object)	Zastaralé. Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Add(String, SqlDbType, Int32, String)	SqlParameter Přidá do SqlParameterCollection pole s názvem parametru, datovým typem a délkou sloupce. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Add(String, SqlDbType, Int32)	SqlParameter Přidá hodnotu do zadaného SqlParameterCollectionnázvu SqlDbType a velikosti parametru. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Add(String, SqlDbType)	SqlParameter Přidá do SqlParameterCollection daného názvu parametru a datového typu. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
AddRange(Array)	Přidá pole hodnot na konec SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
AddRange(SqlParameter[])	Přidá pole SqlParameter hodnot na konec SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
AddWithValue(String, Object)	Přidá hodnotu na konec SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Clear()	Odebere všechny SqlParameter objekty z objektu SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Contains(Object)	Určuje, zda zadaný Object je v tomto SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Contains(SqlParameter)	Určuje, zda zadaný SqlParameter je v tomto SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Contains(String)	Určuje, zda je zadaný název parametru v tomto SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí enumerátor, který iteruje přes SqlParameterCollection. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. 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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IndexOf(SqlParameter)	Získá umístění zadané SqlParameter v kolekci. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
IndexOf(String)	Získá umístění zadaného SqlParameter s zadaným názvem. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
InitializeLifetimeService()	Zastaralé. 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 indexuObject.SqlParameterCollection Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Insert(Int32, SqlParameter)	Vloží SqlParameter objekt do zadaného indexu SqlParameterCollection . Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Remove(SqlParameter)	Odebere zadanou SqlParameter položku z kolekce. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
RemoveAt(Int32)	Odebere SqlParameter ze zadaného indexu SqlParameterCollection . Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
RemoveAt(String)	Odebere SqlParameter ze zadaného názvu parametru SqlParameterCollection . Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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í

Název	Description
ICollection.IsSynchronized	Získá hodnotu označující, zda je přístup k ICollection této synchronizaci (bezpečné vlákno). (Zděděno od DbParameterCollection)
IDataParameterCollection.Item[String]	Získá nebo nastaví parametr v zadaném indexu. (Zděděno od DbParameterCollection)
IList.IsFixedSize	Získá hodnotu určující, zda IList má pevnou velikost. (Zděděno od DbParameterCollection)
IList.IsReadOnly	Získá hodnotu určující, zda je jen pro IList čtení. (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í

Název	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.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?