SqlParameterCollection Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

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. 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 se používají k výběru dat v rámci zdroje dat a k naplnění objektu DataSet. Tento kód předpokládá, že DataSet objekty a a SqlDataAdapter již byly vytvořeny s odpovídajícím schématem, příkazy a připojením.

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í 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 vzorovým kódem demonstrujícím použití parametrů najdete v tématu Příkazy a parametry.

Vlastnosti

Count	Vrátí hodnotu typu Integer, 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á v SqlParameter 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, Object)	Zastaralé. Přidá zadaný SqlParameter objekt do objektu SqlParameterCollection.
Add(String, SqlDbType)	SqlParameter Přidá k SqlParameterCollection danému názvu parametru a datovému typu .
Add(String, SqlDbType, Int32)	SqlParameter Přidá do parametru SqlParameterCollection, a to s ohledem na zadaný název SqlDbType parametru a velikost.
Add(String, SqlDbType, Int32, String)	SqlParameter Přidá do SqlParameterCollection parametru 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 hodnota v tomto SqlParameterCollectionsouboru .
Contains(SqlParameter)	Určuje, zda je zadaná SqlParameter hodnota v tomto SqlParameterCollectionsouboru .
Contains(String)	Určuje, zda je zadaný název parametru v tomto SqlParameterCollectionparametru .
CopyTo(Array, Int32)	Zkopíruje všechny prvky aktuálního SqlParameterCollection do zadaného jednorozměrného Array od zadaného cílového Array indexu.
CopyTo(SqlParameter[], Int32)	Zkopíruje všechny prvky aktuálního SqlParameterCollection do zadaného SqlParameterCollection od zadaného cílového indexu.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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í hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, 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()	Type Získá z aktuální instance. (Zděděno od Object)
IndexOf(Object)	Získá umístění zadaného Object v rámci kolekce.
IndexOf(SqlParameter)	Získá umístění zadaného SqlParameter v rámci kolekce.
IndexOf(String)	Získá umístění zadaného SqlParameter se zadaným názvem.
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Insert(Int32, Object)	Vloží do Object objektu SqlParameterCollection v zadaném indexu .
Insert(Int32, SqlParameter)	SqlParameter Vloží objekt do objektu SqlParameterCollection v zadaném indexu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
Remove(Object)	Odebere zadaný SqlParameter objekt z kolekce.
Remove(SqlParameter)	Odebere zadaný SqlParameter objekt z kolekce.
RemoveAt(Int32)	Odebere z SqlParameter objektu SqlParameterCollection v zadaném indexu.
RemoveAt(String)	Odebere z SqlParameter parametru u 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)	Nastaví objekt se DbParameter 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í

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 u zadaného indexu. (Zděděno od DbParameterCollection)

Metody rozšíření

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

Viz také

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