Partilhar via


SqlParameterCollection.Add Método

Definição

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, Object)
Obsoleto.

Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.

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

Um novo objeto SqlParameter.

Exceções

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

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

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

Aplica-se a

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

O índice do novo objeto SqlParameter.

Aplica-se a

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

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

Aplica-se a

Add(String, Object)

Cuidado

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202

Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, object value);
[<System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> Microsoft.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, value As Object) As SqlParameter

Parâmetros

parameterName
String

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

value
Object

Um Object.

Retornos

Um novo objeto SqlParameter.

Tenha cuidado ao usar essa sobrecarga do método SqlParameterCollection.Add para especificar valores de parâmetro de número inteiro. Como essa sobrecarga toma um value do tipo Object, você deve converter o valor integral em um tipo Object quando o valor for zero, como demonstra o exemplo C# a seguir.

parameters.Add("@pname", Convert.ToInt32(0));  

Se você não realizar essa conversão, o compilador assumirá que você está tentando chamar a sobrecarga SqlParameterCollection.Add (string, SqlDbType).

Atributos

Exceções

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

O parâmetro value é nulo.

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

Aplica-se a

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

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.

Aplica-se a

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

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

Aplica-se a