SqlParameterCollection Třída

Reference

Definice

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

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll, System.Data.SqlClient.dll

Balíček:: System.Data.SqlClient v4.8.6

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

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 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.
IsFixedSize	Určuje, jestli má kolekce pevnou velikost. (Zděděno od DbParameterCollection)
IsReadOnly	Získá hodnotu, která označuje, zda SqlParameterCollection je jen pro čtení.
IsReadOnly	Určuje, jestli je kolekce jen pro čtení. (Zděděno od DbParameterCollection)
IsSynchronized	Získá hodnotu, která označuje, zda SqlParameterCollection je synchronizován.
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, 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()	Zastaralé. 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()	Zastaralé. 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í

ICollection.IsSynchronized	Získá hodnotu označující, zda přístup k objektu ICollection je synchronizován (bezpečný pro přístup z více vláken). (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 označující, zda IList má pevnou velikost. (Zděděno od DbParameterCollection)
IList.IsReadOnly	Získá hodnotu, která určuje, zda je IList určena jen pro čtení. (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 IEnumerable IQueryable.

Platí pro

Sdílet prostřednictvím