Método SqlCeParameterCollection.Add (String, Object)
Observação: essa API está obsoleta.
Adiciona um SqlCeParameter à SqlCeParameterCollection, dados o nome e o valor do parâmetro.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
<ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).", _
False)> _
Public Function Add ( _
parameterName As String, _
value As Object _
) As SqlCeParameter
'Uso
Dim instance As SqlCeParameterCollection
Dim parameterName As String
Dim value As Object
Dim returnValue As SqlCeParameter
returnValue = instance.Add(parameterName, _
value)
[ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)]
public SqlCeParameter Add(
string parameterName,
Object value
)
[ObsoleteAttribute(L"Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)]
public:
SqlCeParameter^ Add(
String^ parameterName,
Object^ value
)
[<ObsoleteAttribute("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value).",
false)>]
member Add :
parameterName:string *
value:Object -> SqlCeParameter
public function Add(
parameterName : String,
value : Object
) : SqlCeParameter
Parâmetros
- parameterName
Tipo: System.String
O nome do parâmetro.
- value
Tipo: System.Object
O valor Object do SqlCeParameter a ser adicionado à coleção.
Valor de retorno
Tipo: System.Data.SqlServerCe.SqlCeParameter
Uma referência ao novo objeto SqlCeParameter.
Exceções
| Exceção | Condição |
|---|---|
| InvalidCastException | O objeto fornecido como o parâmetro value não pode ser convertido em uma cadeia de caracteres. Isso poderá ocorrer se o objeto não for um tipo primitivo, SqlDbType ou matriz de bytes. |
Comentários
O SqlDbType do novo objeto SqlCeParameter não é inferido do tipo .NET Compact Framework do parâmetro value. A propriedade Value do novo objeto SqlCeParameter é definida como a cadeia de caracteres obtida da conversão do parâmetro value e o SqlDbType é definido como SqlDbType.NChar.
Se desejar definir explicitamente o SqlDbType do parâmetro ao criá-lo, use um dos outros métodos Add sobrecarregados.
Exemplos
O exemplo a seguir adiciona um novo elemento a uma SqlCeParameterCollection. Ele presume que um SqlCeCommand já foi criado.
cmd.Parameters.Add("@Description", "Beverages")
cmd.Parameters.Add("@Description", "Beverages");