IDataParameter.Value Propriedade

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Obtém ou define o valor do parâmetro.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

public object? Value { get; set; }

member this.Value : obj with get, set

Public Property Value As Object

Valor da propriedade

Object

Um Object que é o valor do parâmetro. O valor padrão é nulo.

Exemplos

O exemplo a seguir cria uma instância da classe de implementação, SqlParameter, e define algumas de suas propriedades.

public void CreateSqlParameter()
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.Value = "garden hose";
    parameter.Size = 11;
}

Public Sub CreateSqlParameter()
    Dim parameter As New SqlParameter( _
        "@Description", SqlDbType.VarChar)
    parameter.Value = "garden hose"
    parameter.Size = 11
End Sub

Comentários

Para parâmetros de entrada, o valor é associado ao IDbCommand que é enviado ao servidor. Para parâmetros de valor retornado e de saída, o valor é definido após a IDbCommand conclusão do e depois que o IDataReader é fechado.

Ao enviar um valor de parâmetro nulo para o servidor, o usuário deve especificar DBNull, não nulo. O valor nulo no sistema é um objeto vazio que não tem nenhum valor. DBNull é usado para representar valores nulos.

Se o aplicativo especificar o tipo de banco de dados, o valor associado será convertido nesse tipo quando o provedor enviar os dados para o servidor. O provedor tentará converter qualquer tipo de valor se ele der suporte à IConvertible interface . Erros de conversão poderão resultar se o tipo especificado não for compatível com o valor .

A Value propriedade é substituída por Update.