SqlParameterCollection Klas

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Vertegenwoordigt een verzameling parameters die zijn gekoppeld aan een SqlCommand en de bijbehorende toewijzingen aan kolommen in een DataSet. Deze klasse kan niet worden overgenomen.

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : 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
[<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 MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Overname
Object
MarshalByRefObject
SqlParameterCollection
Overname
Object
MarshalByRefObject
DbParameterCollection
SqlParameterCollection
Kenmerken
ListBindableAttribute
Implementeringen
ICollection IEnumerable IList IDataParameterCollection

Voorbeelden

In het volgende voorbeeld worden meerdere exemplaren van SqlParameter de SqlParameterCollection verzameling gemaakt. De parameters worden gebruikt om gegevens in de gegevensbron te selecteren en de DataSet. Bij deze code wordt ervan uitgegaan dat een DataSet en een SqlDataAdapter al zijn gemaakt met het juiste schema, opdrachten en verbinding.

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

Opmerkingen

Als de opdracht een ad-hoc SQL-instructie bevat, moet het aantal parameters in de verzameling gelijk zijn aan het aantal tijdelijke aanduidingen voor parameters in de opdrachttekst, of SQL Server een fout veroorzaakt. Met een opgeslagen procedure moeten alle parameters die zijn gedeclareerd in de opgeslagen procedure zonder standaardwaarde worden opgegeven. Parameters die zijn gedeclareerd met een standaardwaarde, zijn optioneel. Hiermee kunt u een andere waarde dan de standaardwaarde opgeven.

Zie Opdrachten en parameters voor meer informatie over aanvullende voorbeeldcode die laat zien hoe u parameters gebruikt.

Eigenschappen

Name Description
Count

Retourneert een geheel getal dat het aantal elementen in de SqlParameterCollection. Alleen lezen.
IsFixedSize

Hiermee wordt een waarde opgehaald die aangeeft of de grootte van de SqlParameterCollection waarde vast is.
IsReadOnly

Hiermee wordt een waarde opgehaald die aangeeft of het SqlParameterCollection kenmerk Alleen-lezen is.
IsSynchronized

Hiermee wordt een waarde opgehaald die aangeeft of de SqlParameterCollection synchronisatie is uitgevoerd.
Item[Int32]

Haalt de SqlParameter opgegeven index op.
Item[String]

Hiermee haalt u de SqlParameter met de opgegeven naam op.
SyncRoot

Hiermee haalt u een object op dat kan worden gebruikt om de toegang tot het SqlParameterCollectionobject te synchroniseren.

Methoden

Name Description
Add(Object)

Hiermee voegt u het opgegeven SqlParameter object toe aan de SqlParameterCollection.
Add(SqlParameter)

Hiermee voegt u het opgegeven SqlParameter object toe aan de SqlParameterCollection.
Add(String, Object)
Verouderd.

Hiermee voegt u het opgegeven SqlParameter object toe aan de SqlParameterCollection.
Add(String, SqlDbType, Int32, String)

Voegt een SqlParameter waarde toe aan de SqlParameterCollection parameternaam, het gegevenstype en de kolomlengte.
Add(String, SqlDbType, Int32)

Hiermee voegt u een SqlParameter toe aan de SqlParameterCollectionnaam en grootte van de opgegeven parameter SqlDbType .
Add(String, SqlDbType)

Hiermee voegt u een SqlParameter waarde toe aan de SqlParameterCollection opgegeven parameternaam en het gegevenstype.
AddRange(Array)

Voegt een matrix met waarden toe aan het einde van de SqlParameterCollection.
AddRange(SqlParameter[])

Voegt een matrix met SqlParameter waarden toe aan het einde van de SqlParameterCollection.
AddWithValue(String, Object)

Voegt een waarde toe aan het einde van de SqlParameterCollection.
Clear()

Hiermee verwijdert u alle SqlParameter objecten uit de SqlParameterCollection.
Contains(Object)

Bepaalt of de opgegeven Object staat in deze SqlParameterCollection.
Contains(SqlParameter)

Bepaalt of de opgegeven SqlParameter staat in deze SqlParameterCollection.
Contains(String)

Bepaalt of de opgegeven parameternaam zich in deze SqlParameterCollectionbevindt.
CopyTo(Array, Int32)

Kopieert alle elementen van de huidige SqlParameterCollection naar de opgegeven eendimensionale Array vanaf de opgegeven doelindex Array .
CopyTo(SqlParameter[], Int32)

Kopieert alle elementen van de huidige SqlParameterCollection naar de opgegeven vanaf de opgegeven SqlParameterCollection doelindex.
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetEnumerator()

Retourneert een enumerator die door de SqlParameterCollection.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLifetimeService()

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetParameter(Int32)

Retourneert het DbParameter object op de opgegeven index in de verzameling.

(Overgenomen van DbParameterCollection)
GetParameter(String)

Retourneert DbParameter het object met de opgegeven naam.

(Overgenomen van DbParameterCollection)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
IndexOf(Object)

Hiermee haalt u de locatie op van de opgegeven Object in de verzameling.
IndexOf(SqlParameter)

Hiermee haalt u de locatie op van de opgegeven SqlParameter in de verzameling.
IndexOf(String)

Hiermee haalt u de locatie op van de opgegeven SqlParameter met de opgegeven naam.
InitializeLifetimeService()

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
Insert(Int32, Object)

Hiermee voegt u een Object in de SqlParameterCollection opgegeven index in.
Insert(Int32, SqlParameter)

Hiermee voegt u een SqlParameter object in de SqlParameterCollection opgegeven index in.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
Remove(Object)

Hiermee verwijdert u de opgegeven SqlParameter uit de verzameling.
Remove(SqlParameter)

Hiermee verwijdert u de opgegeven SqlParameter uit de verzameling.
RemoveAt(Int32)

Hiermee verwijdert u de SqlParameter uit de SqlParameterCollection opgegeven index.
RemoveAt(String)

Hiermee verwijdert u de SqlParameter uit de SqlParameterCollection opgegeven parameternaam.
SetParameter(Int32, DbParameter)

Hiermee stelt u het DbParameter object in de opgegeven index in op een nieuwe waarde.

(Overgenomen van DbParameterCollection)
SetParameter(String, DbParameter)

Hiermee stelt u het DbParameter object met de opgegeven naam in op een nieuwe waarde.

(Overgenomen van DbParameterCollection)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Expliciete interface-implementaties

Name Description
IDataParameterCollection.Item[String]

Hiermee haalt u de parameter op of stelt u deze in op de opgegeven index.

(Overgenomen van DbParameterCollection)
IList.Item[Int32]

Hiermee haalt u het element op de opgegeven index op of stelt u het in.

(Overgenomen van DbParameterCollection)

Extensiemethoden

Name Description
AsParallel(IEnumerable)

Hiermee schakelt u parallelle uitvoering van een query in.
AsQueryable(IEnumerable)

Converteert een IEnumerable naar een IQueryable.
Cast<TResult>(IEnumerable)

Cast de elementen van een IEnumerable naar het opgegeven type.
OfType<TResult>(IEnumerable)

Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type.

Van toepassing op

Zie ook