SqlParameterCollection.Add SqlParameterCollection.Add SqlParameterCollection.Add SqlParameterCollection.Add Method

Definição

Sobrecargas

Add(SqlParameter) Add(SqlParameter) Add(SqlParameter) Add(SqlParameter)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(Object) Add(Object) Add(Object) Add(Object)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) 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.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

Add(SqlParameter) Add(SqlParameter) Add(SqlParameter) Add(SqlParameter)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::Data::SqlClient::SqlParameter ^ value);
public System.Data.SqlClient.SqlParameter Add (System.Data.SqlClient.SqlParameter value);
member this.Add : System.Data.SqlClient.SqlParameter -> System.Data.SqlClient.SqlParameter
Public Function Add (value As SqlParameter) As SqlParameter

Parâmetros

value
SqlParameter SqlParameter SqlParameter SqlParameter

O SqlParameter a adicionar à coleção.The SqlParameter to add to the collection.

Retornos

Exceções

O SqlParameter especificado no parâmetro value já foi adicionado a este ou a outro SqlParameterCollection.The SqlParameter specified in the value parameter is already added to this or another SqlParameterCollection.

O parâmetro passado não é um SqlParameter.The parameter passed was not a SqlParameter.

O parâmetro value é nulo.The value parameter is null.

Exemplos

public void AddSqlParameter(SqlCommand command) 
{
    command.Parameters.Add(new SqlParameter("Description", "Beverages"));
}
Public Sub AddSqlParameter(command As SqlCommand) 
  command.Parameters.Add(New SqlParameter("Description", "Beverages"))
End Sub
Veja também

Add(Object) Add(Object) Add(Object) Add(Object)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 virtual int Add(System::Object ^ value);
public int Add (object value);
abstract member Add : obj -> int
override this.Add : obj -> int
Public Function Add (value As Object) As Integer

Parâmetros

Retornos

O índice do novo objeto SqlParameter.The index of the new SqlParameter object.

Implementações

Veja também

Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);
member this.Add : string * System.Data.SqlDbType -> System.Data.SqlClient.SqlParameter

Parâmetros

parameterName
String String String String

O nome do parâmetro.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

Um dos valores de SqlDbType.One of the SqlDbType values.

Retornos

Exemplos

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = command.Parameters.Add(
        "@Description", SqlDbType.NVarChar);
    param.Size = 16;
    param.Value = "Beverages";
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As SqlParameter = command.Parameters.Add( _
      "@Description", SqlDbType.NVarChar)
  param.Size = 16
  param.Value = "Beverages"
End Sub
Veja também

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Aviso

Esta API agora é obsoleta.

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);
[System.Obsolete("Do not call this method.")]
[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 System.Data.SqlClient.SqlParameter Add (string parameterName, object value);
override this.Add : string * obj -> System.Data.SqlClient.SqlParameter
Public Function Add (parameterName As String, value As Object) As SqlParameter

Parâmetros

parameterName
String String String String

O nome do SqlParameter para adicionar à coleção.The name of the SqlParameter to add to the collection.

Retornos

Um novo objeto SqlParameter.A new SqlParameter object.

Tenha cuidado ao usar essa sobrecarga do método SqlParameterCollection.Add para especificar valores de parâmetro de número inteiro.Use caution when you are using this overload of the SqlParameterCollection.Add method to specify integer parameter values. 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.Because this overload takes a value of type Object, you must convert the integral value to an Object type when the value is zero, as the following C# example demonstrates.

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).If you do not perform this conversion, the compiler assumes that you are trying to call the SqlParameterCollection.Add (string, SqlDbType) overload.

Exceções

O SqlParameter especificado no parâmetro value já foi adicionado a este ou a outro SqlParameterCollection.The SqlParameter specified in the value parameter is already added to this or another SqlParameterCollection.

O parâmetro value é nulo.The value parameter is null.

Exemplos

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As SqlParameter = New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub
Veja também

Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);
member this.Add : string * System.Data.SqlDbType * int -> System.Data.SqlClient.SqlParameter

Parâmetros

parameterName
String String String String

O nome do parâmetro.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

O SqlDbType do SqlParameter para adicionar à coleção.The SqlDbType of the SqlParameter to add to the collection.

size
Int32 Int32 Int32 Int32

O tamanho como um Int32.The size as an Int32.

Retornos

Exemplos

public void AddSqlParameter(SqlCommand command) 
{
    SqlParameter param = new SqlParameter(
        "@Description", SqlDbType.NVarChar, 16);
    param.Value = "Beverages";
    command.Parameters.Add(param);
}
Public Sub AddSqlParameter(command As SqlCommand) 
  Dim param As SqlParameter = New SqlParameter( _
      "@Description", SqlDbType.NVarChar, 16)
  param.Value = "Beverages"
  command.Parameters.Add(param)
End Sub

Comentários

Essa sobrecarga é útil quando você está adicionando um parâmetro de um tipo de dados de comprimento variável, varchar como binaryou.This overload is useful when you are adding a parameter of a variable-length data type such as varchar or binary.

Veja também

Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) 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.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

public:
 System::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);
public System.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);
member this.Add : string * System.Data.SqlDbType * int * string -> System.Data.SqlClient.SqlParameter

Parâmetros

parameterName
String String String String

O nome do parâmetro.The name of the parameter.

sqlDbType
SqlDbType SqlDbType SqlDbType SqlDbType

Um dos valores de SqlDbType.One of the SqlDbType values.

size
Int32 Int32 Int32 Int32

O comprimento da coluna.The column length.

sourceColumn
String String String String

O nome da coluna de origem (SourceColumn) se este SqlParameter for usado em uma chamada a Update.The name of the source column (SourceColumn) if this SqlParameter is used in a call to Update.

Retornos

Exemplos

public void AddSqlParameter(SqlCommand cmd) 
{
  SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
}
Public Sub AddSqlParameter(cmd As SqlCommand) 
  Dim p1 As SqlParameter = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description")
End Sub
Veja também

Aplica-se a