SqlParameter.Value Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o valor do parâmetro.
public:
property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };public:
virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };[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; }[<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, setPublic Property Value As ObjectPublic Overrides Property Value As ObjectValor de Propriedade
E Object esse é o valor do parâmetro. O valor padrão é null.
Implementações
- Atributos
Exemplos
O exemplo seguinte cria um SqlParameter e define algumas das 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
Observações
Para os parâmetros de entrada, o valor é atribuído ao SqlCommand que é enviado ao servidor. Para os parâmetros de valor de saída e retorno, o valor é definido na conclusão do SqlCommand e após o fechamento SqlDataReader .
Esta propriedade pode ser definida como null ou DBNull.Value. Use DBNull.Value para enviar um valor NULL como valor do parâmetro. Use null ou não defina Value para usar o valor padrão do parâmetro.
É lançada uma exceção se dados XML não Unicode forem passados como uma cadeia.
Se a aplicação especificar o tipo de base de dados, o valor limitado é convertido para esse tipo quando o fornecedor envia os dados para o servidor. O fornecedor tenta converter qualquer tipo de valor se suportar a IConvertible interface. Podem ocorrer erros de conversão se o tipo especificado não for compatível com o valor.
Ambas as DbType propriedades e SqlDbType podem ser inferidas definindo o Valor.
A Value propriedade é sobrescrita por SqlDataAdapter.UpdateCommand.
Para informações sobre streaming, consulte SqlClient Streaming Support.