Sdílet prostřednictvím

SqlParameter.Value Vlastnost

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Zdroj:
System.Data.SqlClient.notsupported.cs

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í hodnota je 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ázána na SqlCommand odesílanou na server. U parametrů výstupní a návratové hodnoty se hodnota nastaví po dokončení SqlCommand a po zavření SqlDataReader .

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

Výjimka se vyvolá, pokud se data XML jiného kódu než Unicode předávají jako řetězec.

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

Obě vlastnosti DbTypeSqlDbType lze odvodit nastavením hodnoty.

Vlastnost Value je přepsána SqlDataAdapter.UpdateCommand.

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

Platí pro

Viz také