SqlParameter Класс

Ссылка

Определение

Пространство имен:: 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 SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

type SqlParameter = class
    inherit DbParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

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

DbParameter
SqlParameter

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

MarshalByRefObject

DbParameter
SqlParameter

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

MarshalByRefObject
SqlParameter

Атрибуты: TypeConverterAttribute

Реализации: IDataParameter IDbDataParameter ICloneable

Примеры

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

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

Конструкторы

SqlParameter()	Инициализирует новый экземпляр класса SqlParameter.
SqlParameter(String, Object)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и значение нового объекта SqlParameter.
SqlParameter(String, SqlDbType)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и тип данных.
SqlParameter(String, SqlDbType, Int32)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, SqlDbType и размер.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, тип, размер, направление ParameterDirection, точность, масштаб, исходный столбец, версию DataRowVersion и значение параметра.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, тип параметра, длину параметра, направление, точность, масштаб, имя исходного столбца, одно из значений DataRowVersion, логическое значение для сопоставления исходных столбцов, значение для `SqlParameter`, имя базы данных, в которой находится коллекция схем для данного экземпляра XML, реляционную схему-владельца, в которой находится коллекция схем для данного экземпляра XML, и имя коллекции схем для этого параметра.
SqlParameter(String, SqlDbType, Int32, String)	Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, SqlDbType, размер и имя исходного столбца.

Свойства

CompareInfo	Получает или задает объект CompareInfo, который определяет порядок сравнения строк для этого параметра.
DbType	Возвращает или устанавливает тип SqlDbType параметра.
Direction	Возвращает или задает значение, указывающее, является ли параметр только входным, только выходным, двунаправленным или параметром, возвращаемым хранимой процедурой.
ForceColumnEncryption	Обеспечивает шифрование параметра при использовании функции Always Encrypted. Если SQL Server сообщает драйверу, что параметр не должен быть зашифрован, запрос, использующий параметр, завершится ошибкой. Это свойство обеспечивает дополнительную защиту от атак на систему безопасности, включающих предоставление клиенту скомпрометированным SQL Server неверных метаданных шифрования, что может привести к раскрытию данных.
IsNullable	Возвращает или задает значение, указывающее, принимает ли этот параметр значения NULL. IsNullable не используется для проверки значения параметра и не препятствует отправке или получению значения NULL при выполнении команды.
LocaleId	Получает или задает идентификатор языкового стандарта, определяющий соглашения и язык для конкретного региона.
Offset	Получает или задает смещение для свойства Value.
ParameterName	Возвращает или задает имя таблицы для объекта SqlParameter.
Precision	Возвращает или задает максимальное количество цифр, используемых для представления свойства Value.
Scale	Возвращает или задает число десятичных разрядов, до которых вычисляется значение Value.
Size	Возвращает или задает максимальный размер (в байтах) данных внутри столбца.
SourceColumn	Возвращает или задает имя исходного столбца, сопоставленного DataSet и используемого для загрузки или возвращения значения Value.
SourceColumnNullMapping	Возвращает или задает значение, показывающее, допускает ли исходный столбец значения NULL. Это позволяет SqlCommandBuilder правильно создавать инструкции Update для столбцов со значением NULL.
SourceVersion	Возвращает или задает значение DataRowVersion, используемое при загрузке Value.
SourceVersion	Возвращает или задает значение DataRowVersion, используемое при загрузке Value. (Унаследовано от DbParameter)
SqlDbType	Возвращает или устанавливает тип SqlDbType параметра.
SqlValue	Возвращает или задает значение параметра как тип SQL.
TypeName	Возвращает или задает имя типа для возвращающего табличное значение параметра.
UdtTypeName	Возвращает или задает объект `string`, представляющий определяемый пользователем тип в качестве параметра.
Value	Возвращает или задает значение параметра.
XmlSchemaCollectionDatabase	Возвращает имя базы данных, в которой находится коллекция схем для данного экземпляра XML.
XmlSchemaCollectionName	Возвращает имя коллекции схем для данного экземпляра XML.
XmlSchemaCollectionOwningSchema	Реляционная схема-владелец, в которой находится коллекция схем для данного экземпляра XML.

Методы

CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
ResetDbType()	Сбрасывает тип, связанный с параметром SqlParameter.
ResetSqlDbType()	Сбрасывает тип, связанный с параметром SqlParameter.
ToString()	Возвращает строку, содержащую имя ParameterName.

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

ICloneable.Clone()	Описание этого члена см. в разделе Clone().
IDataParameter.SourceVersion	Возвращает или задает значение DataRowVersion при загрузке Value. (Унаследовано от DbParameter)
IDbDataParameter.Precision	Указывает точность числовых параметров. (Унаследовано от DbParameter)
IDbDataParameter.Scale	Описание этого члена см. в разделе Scale. (Унаследовано от DbParameter)

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

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