Udostępnij za pośrednictwem


SqlParameterCollection Klasa

Definicja

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 ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public sealed class SqlParameterCollection : 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
type SqlParameterCollection = class
    inherit 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 DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Dziedziczenie
SqlParameterCollection
Dziedziczenie
Dziedziczenie
SqlParameterCollection
Atrybuty
Implementuje

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.

IsFixedSize

Określa, czy kolekcja ma stały rozmiar.

(Odziedziczone po DbParameterCollection)
IsReadOnly

Pobiera wartość wskazującą, czy SqlParameterCollection element jest tylko do odczytu.

IsReadOnly

Określa, czy kolekcja jest tylko do odczytu.

(Odziedziczone po DbParameterCollection)
IsSynchronized

Pobiera wartość wskazującą, czy SqlParameterCollection element jest zsynchronizowany.

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, 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()
Przestarzałe.

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()
Przestarzałe.

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

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do elementu ICollection jest synchronizowany (bezpieczny wątk).

(Odziedziczone po DbParameterCollection)
IDataParameterCollection.Item[String]

Pobiera lub ustawia parametr w określonym indeksie.

(Odziedziczone po DbParameterCollection)
IList.IsFixedSize

Pobiera wartość wskazującą, czy ma IList stały rozmiar.

(Odziedziczone po DbParameterCollection)
IList.IsReadOnly

Pobiera wartość wskazującą, czy kolekcja IList jest przeznaczona tylko do odczytu.

(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

Dotyczy

Zobacz też