SqlParameterCollection Класс

Ссылка

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Сборки:: netstandard.dll, System.Data.SqlClient.dll

Пакет:: System.Data.SqlClient v4.8.6

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет коллекцию параметров, относящихся к 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

Наследование: Object

DbParameterCollection
SqlParameterCollection

Наследование: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Наследование: Object

MarshalByRefObject
SqlParameterCollection

Атрибуты: ListBindableAttribute

Реализации: ICollection IEnumerable IList IDataParameterCollection

Примеры

В следующем примере создается несколько экземпляров с 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.

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

Продукт	Версии
.NET	Core 1.0, Core 1.1
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0

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

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Подключайтесь, создавайте код и развивайтесь

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