SqlParameterCollection Klasa

Definicja

Reprezentuje kolekcję parametrów skojarzonych z SqlCommand i ich odpowiednie mapowania 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, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Dziedziczenie
SqlParameterCollection
Atrybuty
Implementuje

Przykłady

Poniższy przykład tworzy wiele wystąpień SqlParameter za pomocą kolekcji SqlParameterCollection.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. W tym kodzie założono, że DataSet i SqlDataAdapter zostały już utworzone przy użyciu odpowiedniego schematu, poleceń i połączenia.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.

IsReadOnly

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

IsSynchronized

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

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 obiekt SqlParameter do SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

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

Add(String, Object)

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

Add(String, SqlDbType)

Dodaje SqlParameter do SqlParameterCollection przy użyciu 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, z uwzględnieniem określonej nazwy parametru, SqlDbType i rozmiaru.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String)

Dodaje SqlParameter do 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ę wartości SqlParameter 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 obiekty SqlParameter z SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Określa, czy określony Object znajduje się w tym SqlParameterCollection.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Określa, czy określony SqlParameter znajduje się w tym SqlParameterCollection.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

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

CopyTo(Array, Int32)

Kopiuje wszystkie elementy bieżącego SqlParameterCollection do określonego Array jednowymiarowego, rozpoczynając od określonego docelowego indeksu Array.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 określony obiekt jest równy bieżącemu obiektowi.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()

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)
GetType()

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

(Odziedziczone po Object)
IndexOf(Object)

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

IndexOf(SqlParameter)

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

IndexOf(String)

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

InitializeLifetimeService()

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 SqlParameterCollection o określonym indeksie.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

Wstawia obiekt SqlParameter do SqlParameterCollection o określonym indeksie.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.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 SqlParameterCollection o określonym indeksie.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

Usuwa SqlParameter z SqlParameterCollection o określonej nazwie parametru.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy 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)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też