Поделиться через


SqlParameterCollection Класс

Определение

Представляет коллекцию параметров, относящихся к SqlCommand, а также соответствующие им сопоставления со столбцами в DataSet. Этот класс не наследуется.

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
Наследование
SqlParameterCollection
Наследование
Наследование
SqlParameterCollection
Атрибуты
Реализации

Примеры

В следующем примере создается несколько экземпляров с SqlParameter помощью SqlParameterCollection коллекции . Параметры используются для выбора данных в источнике данных и заполнения DataSet. В этом коде предполагается DataSet , что и уже созданы с соответствующей схемой, командами и подключением SqlDataAdapter .

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

Комментарии

Если команда содержит нерегламентированный sql-оператор, а не имя хранимой процедуры, количество параметров в коллекции должно быть равно количеству заполнителей параметров в тексте команды, иначе SQL Server вызывает ошибку. В хранимой процедуре должны быть указаны все параметры, объявленные в хранимой процедуре без значения по умолчанию. Параметры, объявленные со значением по умолчанию, являются необязательными. Это позволяет указать значение, отличное от значения по умолчанию.

Дополнительные сведения о дополнительных примерах кода, демонстрирующих использование параметров, см. в разделе Команды и параметры.

Свойства

Count

Возвращает целое число, которое содержит количество элементов в SqlParameterCollection. Только для чтения.

IsFixedSize

Получает значение, показывающее, имеет ли объект SqlParameterCollection фиксированный размер.

IsFixedSize

Указывает, имеет ли коллекция фиксированный размер.

(Унаследовано от DbParameterCollection)
IsReadOnly

Получает значение, указывающее, доступен ли объект SqlParameterCollection только для чтения.

IsReadOnly

Указывает, является ли коллекция доступной только для чтения.

(Унаследовано от DbParameterCollection)
IsSynchronized

Возвращает значение, которое определяет, является ли коллекция SqlParameterCollection синхронизированной.

IsSynchronized

Указывает, является ли коллекция синхронизированной.

(Унаследовано от DbParameterCollection)
Item[Int32]

Возвращает объект SqlParameter по указанному индексу.

Item[String]

Возвращает объект SqlParameter с указанным именем.

SyncRoot

Получает объект, с помощью которого можно синхронизировать доступ к коллекции SqlParameterCollection.

Методы

Add(Object)

Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.

Add(SqlParameter)

Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.

Add(String, Object)
Устаревшие..

Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.

Add(String, SqlDbType)

Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем и типом данных параметра.

Add(String, SqlDbType, Int32)

Добавляет SqlParameter в SqlParameterCollection, задавая указанные имя параметра, SqlDbType и размер.

Add(String, SqlDbType, Int32, String)

Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем параметра, типом данных и длиной столбца.

AddRange(Array)

Добавляет массив значений в конец коллекции SqlParameterCollection.

AddRange(SqlParameter[])

Добавляет массив значений SqlParameter в конец коллекции SqlParameterCollection.

AddWithValue(String, Object)

Добавляет значение в конец коллекции SqlParameterCollection.

Clear()

Удаляет все объекты SqlParameter из коллекции SqlParameterCollection.

Contains(Object)

Определяет, находится ли заданный объект Object в этой коллекции SqlParameterCollection.

Contains(SqlParameter)

Определяет, находится ли заданный объект SqlParameter в этой коллекции SqlParameterCollection.

Contains(String)

Определяет, находится ли заданное имя параметра в этой коллекции SqlParameterCollection.

CopyTo(Array, Int32)

Копирует все элементы текущей коллекции SqlParameterCollection в указанный одномерный массив Array, начиная с указанного индекса в массиве Array.

CopyTo(SqlParameter[], Int32)

Копирует все элементы текущей коллекции SqlParameterCollection в указанную коллекцию SqlParameterCollection, начиная с указанного индекса в коллекции назначения.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetEnumerator()

Возвращает перечислитель, осуществляющий перебор элементов списка SqlParameterCollection.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.

(Унаследовано от MarshalByRefObject)
GetParameter(Int32)

Возвращает объект DbParameter по указанному индексу в коллекции.

(Унаследовано от DbParameterCollection)
GetParameter(String)

Возвращает объект DbParameter с заданным именем.

(Унаследовано от DbParameterCollection)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IndexOf(Object)

Возвращает положение указанного объекта Object в коллекции.

IndexOf(SqlParameter)

Возвращает положение указанного объекта SqlParameter в коллекции.

IndexOf(String)

Возвращает положение заданного объекта SqlParameter с указанным именем.

InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
Insert(Int32, Object)

Вставляет объект Object в коллекцию SqlParameterCollection по указанному индексу.

Insert(Int32, SqlParameter)

Вставляет объект SqlParameter в коллекцию SqlParameterCollection по указанному индексу.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
Remove(Object)

Удаляет указанный объект SqlParameter из коллекции.

Remove(SqlParameter)

Удаляет указанный объект SqlParameter из коллекции.

RemoveAt(Int32)

Удаляет объект SqlParameter с указанным индексом из коллекции SqlParameterCollection.

RemoveAt(String)

Удаляет объект SqlParameter с указанным именем из коллекции SqlParameterCollection.

SetParameter(Int32, DbParameter)

Задает новое значение для объекта DbParameter по указанному индексу.

(Унаследовано от DbParameterCollection)
SetParameter(String, DbParameter)

Назначает новое значение объекту DbParameter с указанным именем.

(Унаследовано от DbParameterCollection)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

ICollection.IsSynchronized

Возвращает значение, показывающее, является ли доступ к коллекции ICollection синхронизированным (потокобезопасным).

(Унаследовано от DbParameterCollection)
IDataParameterCollection.Item[String]

Возвращает или задает параметр по указанному индексу.

(Унаследовано от DbParameterCollection)
IList.IsFixedSize

Получает значение, указывающее, имеет ли список IList фиксированный размер.

(Унаследовано от DbParameterCollection)
IList.IsReadOnly

Получает значение, указывающее, является ли объект IList доступным только для чтения.

(Унаследовано от DbParameterCollection)
IList.Item[Int32]

Возвращает или задает элемент по указанному индексу.

(Унаследовано от DbParameterCollection)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.

Применяется к

См. также раздел