SqlParameter Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса SqlParameter.
Перегрузки
SqlParameter() |
Инициализирует новый экземпляр класса SqlParameter. |
SqlParameter(String, SqlDbType) |
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и тип данных. |
SqlParameter(String, Object) |
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и значение нового объекта SqlParameter. |
SqlParameter(String, SqlDbType, Int32) |
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, SqlDbType и размер. |
SqlParameter(String, SqlDbType, Int32, String) |
Инициализирует новый экземпляр класса 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()
Инициализирует новый экземпляр класса SqlParameter.
public:
SqlParameter();
public SqlParameter ();
Public Sub New ()
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Description";
parameter.IsNullable = true;
parameter.SqlDbType = SqlDbType.VarChar;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)
Dim parameter As New SqlParameter()
With parameter
.ParameterName = "@Description"
.IsNullable = True
.SqlDbType = SqlDbType.VarChar
.Direction = ParameterDirection.Output
.Size = 88
End With
command.Parameters.Add(parameter)
End Sub
См. также раздел
Применяется к
SqlParameter(String, SqlDbType)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и тип данных.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType);
new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command, string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Size = 88;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand, _
ByVal paramValue As String)
Dim parameter As New SqlParameter("@Description", _
SqlDbType.VarChar)
With parameter
.IsNullable = True
.Direction = ParameterDirection.Output
.Size = 88
.Value = paramValue
End With
command.Parameters.Add(parameter)
End Sub
Комментарии
Тип данных и, при необходимости, Размер и Precision выводятся на основе значения dbType
параметра .
См. также раздел
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET
Применяется к
SqlParameter(String, Object)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и значение нового объекта SqlParameter.
public:
SqlParameter(System::String ^ parameterName, System::Object ^ value);
public SqlParameter (string parameterName, object value);
new System.Data.SqlClient.SqlParameter : string * obj -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, value As Object)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- value
- Object
Объект Object, который является значением SqlParameter.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)
Dim parameter As New SqlParameter("@Description", _
SqlDbType.VarChar, 88, "Description")
With parameter
.IsNullable = True
.Direction = ParameterDirection.Output
End With
command.Parameters.Add(parameter)
End Sub
Комментарии
При указании Object в параметре value
SqlDbType объект выводится из типа Microsoft платформа .NET Framework .Object
Будьте внимательны при использовании этой перегрузки конструктора SqlParameter для указания целочисленных значений параметров. Поскольку данная перегруженная версия принимает параметр value
типа Object, необходимо преобразовать целочисленное значение в тип Object, когда значение равно нулю, как показано в следующем примере на C#.
Parameter = new SqlParameter("@pname", (object)0);
Если это преобразование не выполняется, компилятор предполагает, что вы пытаетесь вызвать перегрузку конструктора SqlParameter(String, SqlDbType) .
См. также раздел
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET
Применяется к
SqlParameter(String, SqlDbType, Int32)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, SqlDbType и размер.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);
new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- size
- Int32
Длина параметра.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command,
string paramValue)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88);
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
parameter.Value = paramValue;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand, _
ByVal paramValue As String)
Dim parameter As New SqlParameter("@Description", _
SqlDbType.VarChar, 88)
With parameter
.IsNullable = True
.Direction = ParameterDirection.Output
.Value = paramValue
End With
command.Parameters.Add(parameter)
End Sub
Комментарии
Значение Size выводится из значения параметра, dbType
если оно не задано явным образом в параметре size
.
См. также раздел
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET
Применяется к
SqlParameter(String, SqlDbType, Int32, String)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, SqlDbType, размер и имя исходного столбца.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);
new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- size
- Int32
Длина параметра.
- sourceColumn
- String
Имя исходного столбца (SourceColumn), если этот SqlParameter используется при вызове Update.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 88, "Description");
parameter.IsNullable = true;
parameter.Direction = ParameterDirection.Output;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)
Dim parameter As New SqlParameter("@Description", _
SqlDbType.VarChar, 88, "Description")
With parameter
.IsNullable = True
.Direction = ParameterDirection.Output
End With
command.Parameters.Add(parameter)
End Sub
Комментарии
Значение Size выводится из значения параметра, dbType
если оно не задано явным образом в параметре size
.
См. также раздел
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET
Применяется к
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, тип, размер, направление ParameterDirection, точность, масштаб, исходный столбец, версию DataRowVersion и значение параметра.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);
new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- size
- Int32
Длина параметра.
- direction
- ParameterDirection
Одно из значений перечисления ParameterDirection.
- isNullable
- Boolean
Значение true
, если поле допускает значение NULL, значение false
— в противном случае.
- precision
- Byte
Общее число разрядов слева и справа от десятичной запятой, до которого вычисляется значения Value.
- sourceColumn
- String
Имя исходного столбца (SourceColumn), если этот SqlParameter используется при вызове Update.
- sourceVersion
- DataRowVersion
Одно из значений перечисления DataRowVersion.
- value
- Object
Объект Object, который является значением SqlParameter.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Description",
SqlDbType.VarChar, 11, ParameterDirection.Input,
true, 0, 0, "Description", DataRowVersion.Current,
"garden hose");
parameter.IsNullable = true;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)
Dim parameter As New SqlParameter("@Description", _
SqlDbType.VarChar, 11, ParameterDirection.Input, _
True, 0, 0, "Description", DataRowVersion.Current, _
"garden hose")
parameter.IsNullable = True
command.Parameters.Add(parameter)
End Sub
Комментарии
Размер и Precision выводятся из значения параметра, dbType
если они не заданы явным образом в параметрах size
и precision
.
См. также раздел
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET
Применяется к
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра, тип параметра, длину параметра, направление, точность, масштаб, имя исходного столбца, одно из значений DataRowVersion, логическое значение для сопоставления исходных столбцов, значение для SqlParameter
, имя базы данных, в которой находится коллекция схем для данного экземпляра XML, реляционную схему-владельца, в которой находится коллекция схем для данного экземпляра XML, и имя коллекции схем для этого параметра.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);
new System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- size
- Int32
Длина параметра.
- direction
- ParameterDirection
Одно из значений перечисления ParameterDirection.
- precision
- Byte
Общее число разрядов слева и справа от десятичной запятой, до которого вычисляется значения Value.
- sourceColumn
- String
Имя исходного столбца (SourceColumn), если этот SqlParameter используется при вызове Update.
- sourceVersion
- DataRowVersion
Одно из значений перечисления DataRowVersion.
- sourceColumnNullMapping
- Boolean
true
, если исходный столбец допускает значение NULL, false
— в противном случае.
- value
- Object
Объект Object, который является значением SqlParameter.
- xmlSchemaCollectionDatabase
- String
Имя базы данных, в которой находится коллекция схем для данного экземпляра XML.
- xmlSchemaCollectionOwningSchema
- String
Реляционная схема-владелец, в которой находится коллекция схем для данного экземпляра XML.
- xmlSchemaCollectionName
- String
Имя коллекции схем для данного параметра.
Комментарии
И SizePrecision выводятся из значения параметра, dbType
если они не заданы явным образом в параметрах size
и precision
.
См. также раздел
- Типы данных SQL Server и ADO.NET
- Команды и параметры (ADO.NET)
- Параметры DataAdapter (ADO.NET)
- Использование поставщика данных платформа .NET Framework для SQL Server
- Общие сведения об ADO.NET