SqlParameterCollection Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Egy adott oszlophoz SqlCommand társított paraméterek gyűjteményét és azok oszlopaihoz DataSetvaló leképezését jelöli. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Attribútumok

ListBindableAttribute

Példák

Az alábbi példa több példányt SqlParameter hoz létre a SqlParameterCollection gyűjteményen keresztül. A paraméterek az adatforráson belüli adatok kiválasztására és a DataSet. Ez a kód feltételezi, hogy egy DataSet és egy SqlDataAdapter már létrejött a megfelelő sémával, parancsokkal és kapcsolattal.

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

Megjegyzések

Ha a parancs eseti SQL-utasítást tartalmaz, szemben a tárolt eljárás nevével, akkor a gyűjtemény paramétereinek száma megegyezik a parancsszövegben található paraméterhelyőrzők számával, vagy SQL Server hibát jelez. Tárolt eljárás esetén a tárolt eljárásban alapértelmezett érték nélkül deklarált összes paramétert meg kell adni. Az alapértelmezett értékkel deklarált paraméterek megadása nem kötelező. Ez lehetővé teszi az alapértelmezett értéken kívüli érték megadását.

A paraméterek használatát bemutató további mintakóddal kapcsolatos további információkért tekintse meg a Parancsok és paraméterek című témakört.

Tulajdonságok

Name	Description
Count	Egy egész számot ad vissza, amely a SqlParameterCollection. Read-only.
IsFixedSize	Olyan értéket kap, amely jelzi, hogy a SqlParameterCollection méret rögzített-e.
IsReadOnly	Olyan értéket kap, amely jelzi, hogy az SqlParameterCollection írásvédett-e.
IsSynchronized	Olyan értéket kap, amely jelzi, hogy szinkronizálva SqlParameterCollection van-e.
Item[Int32]	Lekéri a SqlParameter megadott indexet.
Item[String]	Lekéri a SqlParameter megadott nevet.
SyncRoot	Lekéri az objektumot, amely a hozzáférés szinkronizálására használható.SqlParameterCollection

Metódusok

Name	Description
Add(Object)	Hozzáadja a megadott SqlParameter objektumot a SqlParameterCollection.
Add(SqlParameter)	Hozzáadja a megadott SqlParameter objektumot a SqlParameterCollection.
Add(String, Object)	Elavult. Hozzáadja a megadott SqlParameter objektumot a SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	Hozzáad egy SqlParameterSqlParameterCollection paraméternevet, adattípust és oszlophosszt.
Add(String, SqlDbType, Int32)	Hozzáad egy SqlParameter értéket a SqlParameterCollectionmegadott paraméternévhez SqlDbType és mérethez.
Add(String, SqlDbType)	Hozzáad egy paramétert SqlParameter a SqlParameterCollection megadott paraméternévhez és adattípushoz.
AddRange(Array)	Értéktömböt ad hozzá a SqlParameterCollectionvégéhez.
AddRange(SqlParameter[])	Értéktömböt SqlParameter ad hozzá a SqlParameterCollectionvégéhez.
AddWithValue(String, Object)	Értéket ad hozzá a SqlParameterCollectionvégéhez.
Clear()	Eltávolítja az SqlParameter összes objektumot a SqlParameterCollection.
Contains(Object)	Meghatározza, hogy a megadott Object szerepel-e ebben a SqlParameterCollectionnézetben.
Contains(SqlParameter)	Meghatározza, hogy a megadott SqlParameter szerepel-e ebben a SqlParameterCollectionnézetben.
Contains(String)	Meghatározza, hogy a megadott paraméternév szerepel-e ebben a SqlParameterCollectionfájlban.
CopyTo(Array, Int32)	Az aktuális SqlParameterCollection elemeket a megadott célindextől Array kezdve a megadott egydimenziósra Array másolja.
CopyTo(SqlParameter[], Int32)	Másolja az aktuális SqlParameterCollection elemeket a megadott célindextől kezdve a megadott SqlParameterCollection helyre.
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetEnumerator()	Egy enumerátort ad vissza, amely a SqlParameterCollection.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetParameter(Int32)	Visszaadja az DbParameter objektumot a gyűjtemény megadott indexében. (Öröklődés forrása DbParameterCollection)
GetParameter(String)	DbParameter A megadott névvel rendelkező objektumot adja vissza. (Öröklődés forrása DbParameterCollection)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IndexOf(Object)	Lekéri a megadott Object helyet a gyűjteményben.
IndexOf(SqlParameter)	Lekéri a megadott SqlParameter helyet a gyűjteményben.
IndexOf(String)	Lekéri a megadott SqlParameter helyeket a megadott névvel.
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
Insert(Int32, Object)	Beszúr egy Object elemet a SqlParameterCollection megadott indexbe.
Insert(Int32, SqlParameter)	Objektum beszúrása SqlParameter a SqlParameterCollection megadott indexbe.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
Remove(Object)	Eltávolítja a megadottt SqlParameter a gyűjteményből.
Remove(SqlParameter)	Eltávolítja a megadottt SqlParameter a gyűjteményből.
RemoveAt(Int32)	Eltávolítja a SqlParameter megadott indexből SqlParameterCollection .
RemoveAt(String)	Eltávolítja a SqlParameter megadott paraméternévből SqlParameterCollection .
SetParameter(Int32, DbParameter)	DbParameter A megadott indexben lévő objektumot új értékre állítja. (Öröklődés forrása DbParameterCollection)
SetParameter(String, DbParameter)	DbParameter A megadott névvel rendelkező objektumot új értékre állítja. (Öröklődés forrása DbParameterCollection)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
IDataParameterCollection.Item[String]	Lekéri vagy beállítja a paramétert a megadott indexen. (Öröklődés forrása DbParameterCollection)
IList.Item[Int32]	Lekéri vagy beállítja az elemet a megadott indexen. (Öröklődés forrása DbParameterCollection)

Bővítő metódusok

Name	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerableIQueryable.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.

Lásd még

• Parancsok és paraméterek (ADO.NET)
• DataAdapter parameters (ADO.NET)
• A .NET-keretrendszer Data Provider használata SQL Server
• ADO.NET áttekintése