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 и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Применяется к
SqlParameter(String, SqlDbType)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и тип данных.
public:
SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);
public SqlParameter (string parameterName, System.Data.SqlDbType dbType);
new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Комментарии
Тип данных и, при необходимости, Size и Precision выводятся из значения dbType
параметра .
Применяется к
SqlParameter(String, Object)
Инициализирует новый экземпляр класса SqlParameter, использующий имя параметра и значение нового объекта SqlParameter.
public:
SqlParameter(System::String ^ parameterName, System::Object ^ value);
public SqlParameter (string parameterName, object value);
new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, value As Object)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- value
- Object
Объект Object, который является значением SqlParameter.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Комментарии
При указании Object в параметре value
SqlDbType объект выводится из типа Microsoft платформа .NET Framework типа Object.
Будьте внимательны при использовании этой перегрузки конструктора SqlParameter для указания целочисленных значений параметров. Поскольку данная перегруженная версия принимает параметр value
типа Object, необходимо преобразовать целочисленное значение в тип Object, когда значение равно нулю, как показано в следующем примере на C#.
Parameter = new SqlParameter("@pname", (object)0);
Если это преобразование не выполняется, компилятор предполагает, что вы пытаетесь вызвать перегрузку конструктора SqlParameter(String, SqlDbType) .
Применяется к
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter
Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)
Параметры
- parameterName
- String
Имя сопоставляемого параметра.
- size
- Int32
Длина параметра.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Комментарии
Значение Size выводится из значения параметра, dbType
если оно не задано явным образом в параметре size
.
Применяется к
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.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(DataSet)>.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Комментарии
Значение Size выводится из значения параметра, dbType
если оно не задано явным образом в параметре size
.
Применяется к
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.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(DataSet).
- sourceVersion
- DataRowVersion
Одно из значений перечисления DataRowVersion.
- value
- Object
Объект Object, который является значением SqlParameter.
Исключения
Значение, передаваемое в параметре dbType
, имеет недопустимый тип внутренних данных.
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
using Microsoft.Data.SqlClient;
class Program
{
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);
}
}
Комментарии
Размер и Precision выводятся из значения параметра, dbType
если они не заданы явно в параметрах size
и precision
.
Применяется к
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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.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(DataSet)>.
- sourceVersion
- DataRowVersion
Одно из значений перечисления DataRowVersion.
- sourceColumnNullMapping
- Boolean
true
, если исходный столбец допускает значение NULL, false
— в противном случае.
- value
- Object
Объект Object, который является значением SqlParameter.
- xmlSchemaCollectionDatabase
- String
Имя базы данных, в которой находится коллекция схем для данного экземпляра XML.
- xmlSchemaCollectionOwningSchema
- String
Реляционная схема-владелец, в которой находится коллекция схем для данного экземпляра XML.
- xmlSchemaCollectionName
- String
Имя коллекции схем для данного параметра.
Комментарии
И SizePrecision выводятся из значения параметра, dbType
если они явно не заданы в параметрах size
и precision
.