SqlParameterCollection Klass

Definition

Namnområde:

System.Data.SqlClient

Sammansättning:

System.Data.dll

Representerar en samling parametrar som är associerade med en SqlCommand och deras respektive mappningar till kolumner i en DataSet. Det går inte att ärva den här klassen.

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

Arv

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Attribut

ListBindableAttribute

Exempel

I följande exempel skapas flera instanser av SqlParameter via SqlParameterCollection samlingen. Parametrarna används för att välja data i datakällan och fylla i DataSet. Den här koden förutsätter att en DataSet och en SqlDataAdapter redan har skapats med lämpligt schema, kommandon och anslutning.

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

Kommentarer

Om kommandot innehåller en ad hoc SQL-instruktion, till skillnad från ett namn för lagrad procedur, måste antalet parametrar i samlingen vara lika med antalet parameterplatshållare i kommandotexten, eller SQL Server genererar ett fel. Med en lagrad procedur måste alla parametrar som deklareras i den lagrade proceduren utan standardvärde anges. Parametrar som deklareras med ett standardvärde är valfria. På så sätt kan du ange ett annat värde än standardvärdet.

Mer information med ytterligare exempelkod som visar hur du använder parametrar finns i Kommandon och parametrar.

Egenskaper

Name	Description
Count	Returnerar ett heltal som innehåller antalet element i SqlParameterCollection. Read-only.
IsFixedSize	Hämtar ett värde som anger om har SqlParameterCollection en fast storlek.
IsReadOnly	Hämtar ett värde som anger om är SqlParameterCollection skrivskyddat.
IsSynchronized	Hämtar ett värde som anger om synkroniseras SqlParameterCollection .
Item[Int32]	SqlParameter Hämtar vid det angivna indexet.
Item[String]	SqlParameter Hämtar med det angivna namnet.
SyncRoot	Hämtar ett objekt som kan användas för att synkronisera åtkomsten SqlParameterCollectiontill .

Metoder

Name	Description
Add(Object)	Lägger till det angivna SqlParameter objektet i SqlParameterCollection.
Add(SqlParameter)	Lägger till det angivna SqlParameter objektet i SqlParameterCollection.
Add(String, Object)	Föråldrad. Lägger till det angivna SqlParameter objektet i SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	Lägger till en SqlParameter i SqlParameterCollection med parameternamnet, datatypen och kolumnlängden.
Add(String, SqlDbType, Int32)	Lägger till en SqlParameter i SqlParameterCollection, givet det angivna parameternamnet SqlDbType och storleken.
Add(String, SqlDbType)	Lägger till ett SqlParameter i det SqlParameterCollection angivna parameternamnet och datatypen.
AddRange(Array)	Lägger till en matris med värden i slutet av SqlParameterCollection.
AddRange(SqlParameter[])	Lägger till en matris med SqlParameter värden i slutet av SqlParameterCollection.
AddWithValue(String, Object)	Lägger till ett värde i slutet av SqlParameterCollection.
Clear()	Tar bort alla SqlParameter objekt från SqlParameterCollection.
Contains(Object)	Avgör om den angivna Object finns i den här SqlParameterCollection.
Contains(SqlParameter)	Avgör om den angivna SqlParameter finns i den här SqlParameterCollection.
Contains(String)	Avgör om det angivna parameternamnet finns i den här SqlParameterCollection.
CopyTo(Array, Int32)	Kopierar alla element i strömmen SqlParameterCollection till den angivna endimensionella Array med början vid det angivna målindexet Array .
CopyTo(SqlParameter[], Int32)	Kopierar alla element i den aktuella SqlParameterCollection till den angivna SqlParameterCollection med början vid det angivna målindexet.
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetEnumerator()	Returnerar en uppräkning som itererar genom SqlParameterCollection.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetParameter(Int32)	Returnerar objektet DbParameter vid det angivna indexet i samlingen. (Ärvd från DbParameterCollection)
GetParameter(String)	Returnerar DbParameter objektet med det angivna namnet. (Ärvd från DbParameterCollection)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
IndexOf(Object)	Hämtar platsen för den angivna Object i samlingen.
IndexOf(SqlParameter)	Hämtar platsen för den angivna SqlParameter i samlingen.
IndexOf(String)	Hämtar platsen för den angivna SqlParameter med det angivna namnet.
InitializeLifetimeService()	Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
Insert(Int32, Object)	Infogar en Object i SqlParameterCollection vid det angivna indexet.
Insert(Int32, SqlParameter)	Infogar ett SqlParameter objekt i SqlParameterCollection det angivna indexet.
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
Remove(Object)	Tar bort den angivna SqlParameter från samlingen.
Remove(SqlParameter)	Tar bort den angivna SqlParameter från samlingen.
RemoveAt(Int32)	Tar SqlParameter bort från SqlParameterCollection vid det angivna indexet.
RemoveAt(String)	Tar SqlParameter bort från SqlParameterCollection vid det angivna parameternamnet.
SetParameter(Int32, DbParameter)	Anger objektet DbParameter vid det angivna indexet till ett nytt värde. (Ärvd från DbParameterCollection)
SetParameter(String, DbParameter)	Anger objektet DbParameter med det angivna namnet till ett nytt värde. (Ärvd från DbParameterCollection)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Explicita gränssnittsimplementeringar

Name	Description
IDataParameterCollection.Item[String]	Hämtar eller anger parametern vid det angivna indexet. (Ärvd från DbParameterCollection)
IList.Item[Int32]	Hämtar eller anger elementet vid det angivna indexet. (Ärvd från DbParameterCollection)

Tilläggsmetoder

Name	Description
AsParallel(IEnumerable)	Möjliggör parallellisering av en fråga.
AsQueryable(IEnumerable)	Konverterar en IEnumerable till en IQueryable.
Cast<TResult>(IEnumerable)	Omvandlar elementen i en IEnumerable till den angivna typen.
OfType<TResult>(IEnumerable)	Filtrerar elementen i en IEnumerable baserat på en angiven typ.

Se även

• Kommandon och parametrar (ADO.NET)
• DataAdapter Parameters (ADO.NET)
• Använder .NET Framework Data Provider för SQL Server
• översikt över ADO.NET