SqlParameter.SqlValue Propriedade

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.8.6

Obtém ou define o valor do parâmetro como um tipo SQL.

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

public object SqlValue { get; set; }

member this.SqlValue : obj with get, set

Public Property SqlValue As Object

Valor da propriedade

Object

Um Object que é o valor do parâmetro, usando tipos SQL. O valor padrão é nulo.

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 nula ou DBNull.Value. Use DBNull.Value para enviar um valor NULL como o valor do parâmetro . Use nulo ou não defina SqlParameter.SqlValue para usar o valor padrão para o parâmetro .

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 SqlParameter.Value.

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

Use a SqlParameter.Value propriedade para retornar valores de parâmetro como tipos CLR (Common Language Runtime).

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

Confira também

• Tipos de dados do SQL Server e ADO.NET
• Comandos e parâmetros (ADO.NET)
• Parâmetros DataAdapter (ADO.NET)
• Usando o provedor de dados .NET Framework para SQL Server
• Visão geral do ADO.NET