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


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, имя базы данных, в которой находится коллекция схем для данного экземпляра XML, реляционную схему-владельца, в которой находится коллекция схем для данного экземпляра XML, и имя коллекции схем для этого параметра.

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
SqlDbType

Одно из значений перечисления SqlDbType.

Исключения

Значение, передаваемое в параметре 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 параметра .

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

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

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 в параметре valueSqlDbType объект выводится из типа 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 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

Имя сопоставляемого параметра.

dbType
SqlDbType

Одно из значений перечисления SqlDbType.

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 .

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

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

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

Имя сопоставляемого параметра.

dbType
SqlDbType

Одно из значений перечисления SqlDbType.

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 .

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

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

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

Имя сопоставляемого параметра.

dbType
SqlDbType

Одно из значений перечисления SqlDbType.

size
Int32

Длина параметра.

direction
ParameterDirection

Одно из значений перечисления ParameterDirection.

isNullable
Boolean

Значение true, если поле допускает значение NULL, значение false — в противном случае.

precision
Byte

Общее число разрядов слева и справа от десятичной запятой, до которого вычисляется значения Value.

scale
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 .

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

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

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

Имя сопоставляемого параметра.

dbType
SqlDbType

Одно из значений перечисления SqlDbType.

size
Int32

Длина параметра.

direction
ParameterDirection

Одно из значений перечисления ParameterDirection.

precision
Byte

Общее число разрядов слева и справа от десятичной запятой, до которого вычисляется значения Value.

scale
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 .

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

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