SqlParameterCollection.Add Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

Add(SqlParameter)	Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.
Add(Object)	Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.
Add(String, SqlDbType)	Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.
Add(String, SqlDbType, Int32)	Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.
Add(String, SqlDbType, Int32, String)	Adiciona um SqlParameter ao SqlParameterCollection com o nome do parâmetro, o tipo de dados e o comprimento da coluna.

Add(SqlParameter)

Adiciona o objeto SqlParameter especificado ao 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

Parâmetros

value

SqlParameter

O SqlParameter a adicionar à coleção.

Retornos

SqlParameter

Um novo objeto SqlParameter.

Exceções

ArgumentException

O SqlParameter especificado no parâmetro value já foi adicionado a este ou a outro SqlParameterCollection.

InvalidCastException

O parâmetro passado não é um SqlParameter.

ArgumentNullException

O parâmetro value é nulo.

Exemplos

using Microsoft.Data.SqlClient;

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

Add(Object)

Adiciona o objeto SqlParameter especificado ao 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

Parâmetros

value

Object

Um Object.

Retornos

Int32

O índice do novo objeto SqlParameter.

Add(String, SqlDbType)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.

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

Parâmetros

parameterName

String

O nome do parâmetro.

sqlDbType

SqlDbType

Um dos valores de SqlDbType.

Retornos

SqlParameter

Um novo objeto SqlParameter.

Exemplos

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)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.

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

Parâmetros

parameterName

String

O nome do parâmetro.

sqlDbType

SqlDbType

O SqlDbType do SqlParameter para adicionar à coleção.

size

Int32

O tamanho como um Int32.

Retornos

SqlParameter

Um novo objeto SqlParameter.

Exemplos

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);
    }
}

Comentários

Essa sobrecarga é útil quando você está adicionando um parâmetro de um tipo de dados de comprimento variável, como varchar ou binary.

Add(String, SqlDbType, Int32, String)

Adiciona um SqlParameter ao SqlParameterCollection com o nome do parâmetro, o tipo de dados e o comprimento da coluna.

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

Parâmetros

parameterName

String

O nome do parâmetro.

sqlDbType

SqlDbType

Um dos valores de SqlDbType.

size

Int32

O comprimento da coluna.

sourceColumn

String

O nome da coluna de origem (SourceColumn) se este SqlParameter for usado em uma chamada a Update(DataSet).

Retornos

SqlParameter

Um novo objeto SqlParameter.

Exemplos

using Microsoft.Data.SqlClient;

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