SqlParameterCollection.Add Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.SqlParameterPublic Function Add (value As SqlParameter) As SqlParameterParâ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 -> intPublic Overrides Function Add (value As Object) As IntegerParâmetros
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameterParâmetros
- parameterName
- String
O nome do parâmetro.
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.SqlParameterPublic Function Add (parameterName As String, value As Object) As SqlParameterParâmetros
- parameterName
- String
O nome do SqlParameter para adicionar à coleção.
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameterParâmetros
- parameterName
- String
O nome do parâmetro.
- sqlDbType
- SqlDbType
O SqlDbType do SqlParameter para adicionar à coleção.
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.SqlParameterPublic Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameterParâmetros
- parameterName
- String
O nome do parâmetro.
- 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");
}
}