SqlParameterCollection Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

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

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

type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Dědičnost

Object

DbParameterCollection

SqlParameterCollection

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	Určuje, jestli se má kolekce synchronizovat. (Zděděno od DbParameterCollection)
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, 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 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 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.
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)
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.
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)
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)

Metody rozšíření

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