Sdílet prostřednictvím

SqlParameter.Value Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll, System.Data.SqlClient.dll
Balíček:
System.Data.SqlClient v4.8.6

Získá nebo nastaví hodnotu parametru.

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

Hodnota vlastnosti

Object

Jedná Object se o hodnotu parametru . Výchozí hodnotou je hodnota null.

Implementuje

Value
Atributy
TypeConverterAttribute DataSysDescriptionAttribute

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

U vstupních parametrů je hodnota vázaná na SqlCommand hodnotu, která se odešle na server. Pro výstupní parametry a parametry návratové hodnoty se hodnota nastaví po dokončení SqlCommand a po SqlDataReader uzavření.

Tuto vlastnost lze nastavit na null nebo DBNull.Value. Slouží DBNull.Value k odeslání hodnoty NULL jako hodnoty parametru. Použijte null nebo nenastavujte Value výchozí hodnotu parametru.

Pokud se data XML, která nejsou v kódování Unicode, předají jako řetězec, vyvolá se výjimka.

Pokud aplikace určuje typ databáze, převede se vázaná hodnota na tento typ, když zprostředkovatel odešle data na server. Zprostředkovatel se pokusí převést jakýkoli typ hodnoty, pokud podporuje IConvertible rozhraní. Pokud zadaný typ není kompatibilní s hodnotou, může dojít k chybám převodu.

DbType Vlastnosti i SqlDbType lze odvodit nastavením hodnoty .

Vlastnost Value je přepsána uživatelem SqlDataAdapter.UpdateCommand.

Informace o streamování najdete v tématu Podpora streamování SqlClient.

Platí pro

Viz také