SqlParameterCollection Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Reprezentuje kolekcję parametrów skojarzonych z elementem SqlCommand i ich odpowiednie mapowania na kolumny w obiekcie DataSet. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Atrybuty

ListBindableAttribute

Przykłady

Poniższy przykład tworzy wiele wystąpień SqlParameter za pośrednictwem kolekcji SqlParameterCollection . Parametry są używane do wybierania danych w źródle danych i wypełniania .DataSet W tym kodzie przyjęto założenie, że element DataSet i SqlDataAdapter został już utworzony przy użyciu odpowiedniego schematu, poleceń i połączenia.

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

Uwagi

Jeśli polecenie zawiera instrukcję AD hoc SQL, w przeciwieństwie do nazwy procedury składowanej, liczba parametrów w kolekcji musi być równa liczbie symboli zastępczych parametrów w tekście polecenia lub SQL Server zgłasza błąd. W przypadku procedury składowanej należy podać wszystkie parametry zadeklarowane w procedurze składowanej bez wartości domyślnej. Parametry zadeklarowane z wartością domyślną są opcjonalne. Umożliwia to określenie wartości innej niż domyślna.

Aby uzyskać więcej informacji o dodatkowym przykładowym kodzie pokazującym sposób używania parametrów, zobacz Polecenia i parametry.

Właściwości

Count	Zwraca liczbę całkowitą zawierającą liczbę elementów w obiekcie SqlParameterCollection. Tylko do odczytu.
IsFixedSize	Pobiera wartość wskazującą, czy element SqlParameterCollection ma stały rozmiar.
IsReadOnly	Pobiera wartość wskazującą, czy SqlParameterCollection element jest tylko do odczytu.
IsSynchronized	Pobiera wartość wskazującą, czy SqlParameterCollection element jest zsynchronizowany.
Item[Int32]	Pobiera obiekt SqlParameter w określonym indeksie.
Item[String]	Pobiera element SqlParameter o określonej nazwie.
SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu SqlParameterCollection.

Metody

Add(Object)	Dodaje określony SqlParameter obiekt do obiektu SqlParameterCollection.
Add(SqlParameter)	Dodaje określony SqlParameter obiekt do obiektu SqlParameterCollection.
Add(String, Object)	Przestarzałe. Dodaje określony SqlParameter obiekt do obiektu SqlParameterCollection.
Add(String, SqlDbType)	Dodaje element SqlParameter do podanej SqlParameterCollection nazwy parametru i typu danych.
Add(String, SqlDbType, Int32)	SqlParameter Dodaje element do SqlParameterCollectionelementu , przy użyciu określonej nazwy SqlDbType parametru i rozmiaru.
Add(String, SqlDbType, Int32, String)	SqlParameter Dodaje element do elementu SqlParameterCollection z nazwą parametru, typem danych i długością kolumny.
AddRange(Array)	Dodaje tablicę wartości na końcu obiektu SqlParameterCollection.
AddRange(SqlParameter[])	Dodaje tablicę SqlParameter wartości na końcu obiektu SqlParameterCollection.
AddWithValue(String, Object)	Dodaje wartość na końcu elementu SqlParameterCollection.
Clear()	Usuwa wszystkie SqlParameter obiekty z obiektu SqlParameterCollection.
Contains(Object)	Określa, czy określony Object element znajduje się w tym SqlParameterCollectionobiekcie .
Contains(SqlParameter)	Określa, czy określony SqlParameter element znajduje się w tym SqlParameterCollectionobiekcie .
Contains(String)	Określa, czy określona nazwa parametru znajduje się w tym SqlParameterCollectionpliku .
CopyTo(Array, Int32)	Kopiuje wszystkie elementy bieżącego SqlParameterCollection do określonego jednowymiarowego Array indeksu rozpoczynającego się od określonego indeksu docelowego Array .
CopyTo(SqlParameter[], Int32)	Kopiuje wszystkie elementy bieżącego SqlParameterCollection do określonego SqlParameterCollection , zaczynając od określonego indeksu docelowego.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetEnumerator()	Zwraca moduł wyliczający, który iteruje przez element SqlParameterCollection.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetParameter(Int32)	DbParameter Zwraca obiekt w określonym indeksie w kolekcji. (Odziedziczone po DbParameterCollection)
GetParameter(String)	Zwraca DbParameter obiekt o określonej nazwie. (Odziedziczone po DbParameterCollection)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(Object)	Pobiera lokalizację określonej Object w kolekcji.
IndexOf(SqlParameter)	Pobiera lokalizację określonej SqlParameter w kolekcji.
IndexOf(String)	Pobiera lokalizację określonej SqlParameter z określoną nazwą.
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Insert(Int32, Object)	Wstawia element Object do określonego SqlParameterCollection indeksu.
Insert(Int32, SqlParameter)	Wstawia SqlParameter obiekt do SqlParameterCollection obiektu w określonym indeksie.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
Remove(Object)	Usuwa określony SqlParameter element z kolekcji.
Remove(SqlParameter)	Usuwa określony SqlParameter element z kolekcji.
RemoveAt(Int32)	Usuwa element SqlParameter z określonego indeksu SqlParameterCollection .
RemoveAt(String)	Usuwa element SqlParameter z obiektu SqlParameterCollection o określonej nazwie parametru.
SetParameter(Int32, DbParameter)	DbParameter Ustawia obiekt w określonym indeksie na nową wartość. (Odziedziczone po DbParameterCollection)
SetParameter(String, DbParameter)	DbParameter Ustawia obiekt o określonej nazwie na nową wartość. (Odziedziczone po DbParameterCollection)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IDataParameterCollection.Item[String]	Pobiera lub ustawia parametr w określonym indeksie. (Odziedziczone po DbParameterCollection)
IList.Item[Int32]	Pobiera lub ustawia element pod określonym indeksem. (Odziedziczone po DbParameterCollection)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy obiektu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Zobacz też

• Polecenia i parametry (ADO.NET)
• Parametry elementu DataAdapter (ADO.NET)
• Używanie dostawcy danych .NET Framework dla SQL Server
• Omówienie ADO.NET