Sdílet prostřednictvím


SqlParameterCollection Třída

Definice

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
SqlParameterCollection
Dědičnost
Dědičnost
SqlParameterCollection
Atributy
Implementuje

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

Platí pro

Viz také