SqlParameterCollection Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

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

DbParameterCollection

SqlParameterCollection

Atrybuty

ListBindableAttribute

Przykłady

Poniższy przykład tworzy wiele wystąpień SqlParameter za pośrednictwem kolekcji SqlParameterCollection . Parametry służą do wybierania danych w źródle danych i wypełniania parametrów DataSet. Ten kod zakłada, że element DataSet i SqlDataAdapter został już utworzony przy użyciu odpowiedniego schematu, poleceń i połączenia.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    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);

    }
}

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. Pozwala to określić wartość inną 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 elemecie SqlParameterCollection. Tylko do odczytu.
IsFixedSize	Pobiera wartość wskazującą, czy ma SqlParameterCollection stały rozmiar.
IsReadOnly	Pobiera wartość wskazującą, czy jest tylko SqlParameterCollection do odczytu.
Item[Int32]	Pobiera element 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)	Dodaje element do SqlParameterSqlParameterCollectionelementu , przy użyciu podanej nazwy SqlDbType parametru i rozmiaru.
Add(String, SqlDbType, Int32, String)	Dodaje element SqlParameter do SqlParameterCollection elementu o nazwie parametru, typie danych i długości kolumny.
AddRange(Array)	Dodaje tablicę wartości na końcu elementu SqlParameterCollection.
AddRange(SqlParameter[])	Dodaje tablicę SqlParameter wartości na końcu elementu 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ślona Object wartość znajduje się w tym SqlParameterCollectionobiekcie .
Contains(SqlParameter)	Określa, czy określona SqlParameter wartość znajduje się w tym SqlParameterCollectionobiekcie .
Contains(String)	Określa, czy określona nazwa parametru znajduje się w tym SqlParameterCollectionobiekcie .
CopyTo(Array, Int32)	Kopiuje wszystkie elementy bieżącego SqlParameterCollection elementu do określonego jednowymiarowego Array indeksu rozpoczynającego się od określonego indeksu docelowego Array .
CopyTo(SqlParameter[], Int32)	Kopiuje wszystkie elementy bieżącego SqlParameterCollection elementu do określonego SqlParameterCollection , począwszy od określonego indeksu docelowego.
GetEnumerator()	Zwraca moduł wyliczający, który iteruje za pomocą elementu SqlParameterCollection.
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 o określonej nazwie.
Insert(Int32, Object)	Wstawia element Object do określonego indeksu SqlParameterCollection .
Insert(Int32, SqlParameter)	SqlParameter Wstawia obiekt do określonego indeksuSqlParameterCollection.
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 określonej nazwy parametru SqlParameterCollection .