SqlCeParameterCollection.Add Method (String, Object)

Artigo
01/14/2011

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
Public Function Add ( _
    parameterName As String, _
    value As Object _
) As SqlCeParameter

public SqlCeParameter Add (
    string parameterName,
    Object value
)

public:
SqlCeParameter^ Add (
    String^ parameterName, 
    Object^ value
)

public SqlCeParameter Add (
    String parameterName, 
    Object value
)

public function Add (
    parameterName : String, 
    value : Object
) : SqlCeParameter

Parâmetros

parameterName
O nome do parâmetro.

value
O valor Object do SqlCeParameter a ser adicionado à coleção.

Valor de retorno

Uma referência ao novo objeto SqlCeParameter.

Exceções

Tipo de exceção	Condição
InvalidCastException	O objeto fornecido como 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 a partir 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.

Exemplo

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeParameterCollection Class
SqlCeParameterCollection Members
System.Data.SqlServerCe Namespace

Partilhar via