SqlParameterCollection.Add Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

Add(SqlParameter)	Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.
Add(Object)	Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.
Add(String, SqlDbType)	Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем и типом данных параметра.
Add(String, SqlDbType, Int32)	Добавляет SqlParameter в SqlParameterCollection, задавая указанные имя параметра, SqlDbType и размер.
Add(String, SqlDbType, Int32, String)	Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем параметра, типом данных и длиной столбца.

Add(SqlParameter)

Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(Microsoft::Data::SqlClient::SqlParameter ^ value);

public Microsoft.Data.SqlClient.SqlParameter Add (Microsoft.Data.SqlClient.SqlParameter value);

override this.Add : Microsoft.Data.SqlClient.SqlParameter -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (value As SqlParameter) As SqlParameter

Параметры

value

SqlParameter

Параметр SqlParameter для добавления в коллекцию.

Возвращаемое значение

SqlParameter

Новый объект SqlParameter.

Исключения

ArgumentException

SqlParameter, заданный в параметре value, уже добавлен в эту или другую коллекцию SqlParameterCollection.

InvalidCastException

Передан параметр, отличный от объекта SqlParameter.

ArgumentNullException

Параметр value имеет значение null.

Примеры

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        command.Parameters.Add(new SqlParameter("Description", "Beverages"));
    }
}

Add(Object)

Добавляет указанный объект SqlParameter к объекту SqlParameterCollection.

public:
 override int Add(System::Object ^ value);

public override int Add (object value);

override this.Add : obj -> int

Public Overrides Function Add (value As Object) As Integer

Параметры

value

Object

Объект Object.

Возвращаемое значение

Int32

Индекс нового объекта SqlParameter.

Add(String, SqlDbType)

Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем и типом данных параметра.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);

override this.Add : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameter

Параметры

parameterName

String

Имя параметра.

sqlDbType

SqlDbType

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

Возвращаемое значение

SqlParameter

Новый объект SqlParameter.

Примеры

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = command.Parameters.Add(
            "@Description", SqlDbType.NVarChar);
        param.Size = 16;
        param.Value = "Beverages";
    }
}

Add(String, SqlDbType, Int32)

Добавляет SqlParameter в SqlParameterCollection, задавая указанные имя параметра, SqlDbType и размер.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);

override this.Add : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameter

Параметры

parameterName

String

Имя параметра.

sqlDbType

SqlDbType

SqlDbType из SqlParameter для добавления в коллекцию.

size

Int32

Размер Int32.

Возвращаемое значение

SqlParameter

Новый объект SqlParameter.

Примеры

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

Комментарии

Эта перегрузка полезна при добавлении параметра типа данных переменной длины, например varchar или binary.

Add(String, SqlDbType, Int32, String)

Добавляет объект SqlParameter в коллекцию SqlParameterCollection в соответствии с заданным именем параметра, типом данных и длиной столбца.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);

override this.Add : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameter

Параметры

parameterName

String

Имя параметра.

sqlDbType

SqlDbType

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

size

Int32

Длина столбца.

sourceColumn

String

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

Возвращаемое значение

SqlParameter

Новый объект SqlParameter.

Примеры

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand cmd)
    {
        SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
    }
}