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

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр класса 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 .

Исключения

ArgumentException

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

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

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

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

SqlParameterЗначение Object .

Примеры

В следующем примере создается и 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

Используйте осторожность при использовании этой перегрузки конструктора для указания целочисленных значений 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

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

Исключения

ArgumentException

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

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

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

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.

Исключения

ArgumentException

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

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

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

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, если значение поля может быть null; falseв противном случае .

precision: Byte

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

scale: Byte

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

sourceColumn: String

Имя исходного столбца (SourceColumn), если оно SqlParameter используется в вызове Update.

sourceVersion: DataRowVersion

Одно из значений DataRowVersion .

value: Object

SqlParameterЗначение Object .

Исключения

ArgumentException

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

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

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

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, если исходный столбец имеет значение NULL; false Если это не так.

value: Object

SqlParameterЗначение Object .

xmlSchemaCollectionDatabase: String

Имя базы данных, в которой находится коллекция схем для этого экземпляра XML.

xmlSchemaCollectionOwningSchema: String

Собственная реляционная схема, в которой находится коллекция схем для этого экземпляра XML.

xmlSchemaCollectionName: String

Имя коллекции схем для этого параметра.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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

Определение

Перегрузки

SqlParameter()

Примеры

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

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

SqlParameter(String, SqlDbType)

Параметры

Исключения

Примеры

Комментарии

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

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

SqlParameter(String, Object)

Параметры

Примеры

Комментарии

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

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

SqlParameter(String, SqlDbType, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

SqlParameter(String, SqlDbType, Int32, String)

Параметры

Исключения

Примеры

Комментарии

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

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

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Параметры

Исключения

Примеры

Комментарии

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

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

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Параметры

Комментарии

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

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

Обратная связь