SqlParameter.Value Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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

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

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

Valor da propriedade

Object

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

Implementações

Value

Atributos

TypeConverterAttribute

Exemplos

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

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}

Comentários

Para parâmetros de entrada, o valor é associado ao SqlCommand que é enviado ao servidor. Para parâmetros de valor retornado e de saída, 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 poderão 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 de streaming do SqlClient.