SqlParameterCollection Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

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

public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Dziedziczenie

Object

DbParameterCollection

SqlParameterCollection

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	Określa, czy kolekcja jest zsynchronizowana. (Odziedziczone po DbParameterCollection)
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, 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.
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)
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ą.
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)
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)

Metody rozszerzania

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