SqlParameterCollection Klasa

Definicja

Reprezentuje kolekcję parametrów skojarzonych z SqlCommand i odpowiednimi mapowaniami do kolumn w DataSet .Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection
public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
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
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
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
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Dziedziczenie
SqlParameterCollection
Dziedziczenie
Dziedziczenie
SqlParameterCollection
Atrybuty
Implementuje

Przykłady

Poniższy przykład tworzy wiele wystąpień programu SqlParameter za pomocą SqlParameterCollection kolekcji.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Parametry są używane do wybierania danych w źródle danych i wypełniania DataSet .The parameters are used to select data within the data source and populate the DataSet. Ten kod zakłada, że DataSet a i a został SqlDataAdapter już utworzony z odpowiednimi schematami, poleceniami i połączeniami.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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ę SQL ad hoc, w przeciwieństwie do nazwy procedury przechowywanej, liczba parametrów w kolekcji musi być równa liczbie zastępczych parametrów w tekście polecenia lub SQL Server zgłasza błąd.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. W procedurze składowanej należy podać wszystkie parametry zadeklarowane w procedurze składowanej bez wartości domyślnej.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Parametry zadeklarowane z wartością domyślną są opcjonalne.Parameters declared with a default value are optional. Pozwala to określić wartość inną niż domyślna.This lets you specify a value other than the default.

Aby uzyskać więcej informacji o dodatkowym przykładowym kodzie pokazującym sposób użycia parametrów, zobacz polecenia i parametry.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Właściwości

Count

Zwraca liczbę całkowitą, która zawiera liczby elementów w SqlParameterCollection .Returns an Integer that contains the number of elements in the SqlParameterCollection. Tylko do odczytu.Read-only.

IsFixedSize

Pobiera wartość wskazującą, czy SqlParameterCollection ma stały rozmiar.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsFixedSize

Określa, czy rozmiar kolekcji jest stały.Specifies whether the collection is a fixed size.

(Odziedziczone po DbParameterCollection)
IsReadOnly

Pobiera wartość wskazującą, czy SqlParameterCollection jest tylko do odczytu.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsReadOnly

Określa, czy kolekcja jest tylko do odczytu.Specifies whether the collection is read-only.

(Odziedziczone po DbParameterCollection)
IsSynchronized

Pobiera wartość wskazującą, czy SqlParameterCollection jest synchronizowana.Gets a value that indicates whether the SqlParameterCollection is synchronized.

IsSynchronized

Określa, czy kolekcja jest synchronizowana.Specifies whether the collection is synchronized.

(Odziedziczone po DbParameterCollection)
Item[Int32]

Pobiera SqlParameter o określonym indeksie.Gets the SqlParameter at the specified index.

Item[String]

Pobiera SqlParameter o podanej nazwie.Gets the SqlParameter with the specified name.

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do SqlParameterCollection .Gets an object that can be used to synchronize access to the SqlParameterCollection.

Metody

Add(Object)

Dodaje określony SqlParameter obiekt do SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

Dodaje określony SqlParameter obiekt do SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)
Nieaktualne.
Nieaktualne.

Dodaje określony SqlParameter obiekt do SqlParameterCollection .Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

Dodaje SqlParameter do SqlParameterCollection podanej nazwy parametru i typu danych.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

Dodaje SqlParameter do SqlParameterCollection , podaną nazwę parametru SqlDbType i rozmiar.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String)

Dodaje SqlParameter do elementu SqlParameterCollection z nazwą parametru, typem danych i długością kolumny.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

Dodaje tablicę wartości na końcu SqlParameterCollection .Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

Dodaje tablicę SqlParameter wartości na końcu SqlParameterCollection .Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

Dodaje wartość na końcu SqlParameterCollection .Adds a value to the end of the SqlParameterCollection.

Clear()

Usuwa wszystkie SqlParameter obiekty z SqlParameterCollection .Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Określa, czy określono Object w tym elemencie SqlParameterCollection .Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Określa, czy określono SqlParameter w tym elemencie SqlParameterCollection .Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

Określa, czy określona nazwa parametru znajduje się w tym elemencie SqlParameterCollection .Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32)

Kopiuje wszystkie elementy bieżącego SqlParameterCollection do określonego, Array rozpoczynając od określonego Array indeksu docelowego.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32)

Kopiuje wszystkie elementy bieżącego SqlParameterCollection do określonego, SqlParameterCollection rozpoczynając od określonego indeksu docelowego.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Zwraca moduł wyliczający, który wykonuje iterację przez SqlParameterCollection .Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetParameter(Int32)

Zwraca DbParameter obiekt o określonym indeksie w kolekcji.Returns the DbParameter object at the specified index in the collection.

(Odziedziczone po DbParameterCollection)
GetParameter(String)

Zwraca DbParameter obiekt o określonej nazwie.Returns DbParameter the object with the specified name.

(Odziedziczone po DbParameterCollection)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(Object)

Pobiera lokalizację określoną Object w kolekcji.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

Pobiera lokalizację określoną SqlParameter w kolekcji.Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

Pobiera lokalizację określoną SqlParameter z określoną nazwą.Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
Insert(Int32, Object)

Wstawia Object do obiektu SqlParameterCollection o określonym indeksie.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

Wstawia SqlParameter obiekt do obiektu SqlParameterCollection pod określonym indeksem.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Remove(Object)

Usuwa określony SqlParameter z kolekcji.Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

Usuwa określony SqlParameter z kolekcji.Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

Usuwa SqlParameter z programu SqlParameterCollection pod określonym indeksem.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

Usuwa SqlParameter z SqlParameterCollection podanej nazwy parametru.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

SetParameter(Int32, DbParameter)

Ustawia DbParameter obiekt pod określonym indeksem na nową wartość.Sets the DbParameter object at the specified index to a new value.

(Odziedziczone po DbParameterCollection)
SetParameter(String, DbParameter)

Ustawia DbParameter obiekt o określonej nazwie na nową wartość.Sets the DbParameter object with the specified name to a new value.

(Odziedziczone po DbParameterCollection)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do elementu ICollection jest synchronizowany (bezpieczny wątkowo).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Odziedziczone po DbParameterCollection)
IDataParameterCollection.Item[String]

Pobiera lub ustawia parametr o określonym indeksie.Gets or sets the parameter at the specified index.

(Odziedziczone po DbParameterCollection)
IList.Add(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Add(Object) .For a description of this member, see Add(Object).

(Odziedziczone po DbParameterCollection)
IList.Contains(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Contains(Object) .For a description of this member, see Contains(Object).

(Odziedziczone po DbParameterCollection)
IList.IndexOf(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz IndexOf(Object) .For a description of this member, see IndexOf(Object).

(Odziedziczone po DbParameterCollection)
IList.Insert(Int32, Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Insert(Int32, Object) .For a description of this member, see Insert(Int32, Object).

(Odziedziczone po DbParameterCollection)
IList.IsFixedSize

Pobiera wartość wskazującą, czy IList ma stały rozmiar.Gets a value indicating whether the IList has a fixed size.

(Odziedziczone po DbParameterCollection)
IList.IsReadOnly

Pobiera wartość wskazującą, czy kolekcja IList jest przeznaczona tylko do odczytu.Gets a value indicating whether the IList is read-only.

(Odziedziczone po DbParameterCollection)
IList.Item[Int32]

Pobiera lub ustawia element pod określonym indeksem.Gets or sets the element at the specified index.

(Odziedziczone po DbParameterCollection)
IList.Remove(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Remove(Object) .For a description of this member, see Remove(Object).

(Odziedziczone po DbParameterCollection)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy