Compartilhar via


SqlParameter.Value Propriedade

Definição

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

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
[<System.Data.DataSysDescription("DataParameter_Value")>]
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set
Public Overrides Property Value As Object
Public Property Value As Object

Valor da propriedade

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

Implementações

Atributos

Exemplos

O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.

static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}
Private Sub CreateSqlParameterVersion()
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

Comentários

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

Essa propriedade pode ser definida como null ou DBNull.Value. Use DBNull.Value para enviar um valor NULL como o valor do parâmetro . Use null ou não defina Value para usar o valor padrão para o parâmetro .

Uma exceção será gerada se dados XML não Unicode forem passados como uma cadeia de caracteres.

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 podem resultar se o tipo especificado não for compatível com o valor .

DbType As propriedades e SqlDbType podem ser inferidas definindo o Valor.

A Value propriedade é substituída por SqlDataAdapter.UpdateCommand.

Para obter informações sobre streaming, consulte Suporte ao Streaming do SqlClient.

Aplica-se a

Confira também