SqlParameter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет параметр для объекта 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
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
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements 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
Комментарии
В именах параметров регистр символов не учитывается.
Примечание
Безымяные параметры, также называемые порядком, не поддерживаются поставщиком данных .NET Framework для SQL Server.
Дополнительные сведения, а также дополнительные примеры кода, демонстрирующие использование параметров, см. в разделе Команды и параметры.
Конструкторы
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(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 |
Возвращает или задает объект |
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) |