SqlParameter.Value 屬性

  • 參考

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
套件:
System.Data.SqlClient v4.8.6

取得或設定參數的值。

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))]
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
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
Public Overrides Property Value As Object
Public Property Value As Object

屬性值

Object

Object，為參數的值。 預設值為 null。

實作

Value
屬性
TypeConverterAttribute DataSysDescriptionAttribute

範例

下列範例會建立 ， SqlParameter 並設定其部分屬性。

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

備註

針對輸入參數，值會系結至 SqlCommand 傳送至伺服器的 。 針對輸出和傳回值參數，此值會在 完成時 SqlCommand 設定，並在 關閉之後 SqlDataReader 設定。

這個屬性可以設定為 null 或 DBNull.Value。 使用 DBNull.Value 將 NULL 值當做 參數的值傳送。 使用 null 或未設定 Value 為使用 參數的預設值。

如果非 Unicode XML 數據以字串的形式傳遞，則會擲回例外狀況。

如果應用程式指定資料庫類型，當提供者將數據傳送至伺服器時，系結值會轉換成該類型。 如果提供者支援 IConvertible 介面，則嘗試轉換任何類型的值。 如果指定的型別與值不相容，則轉換錯誤可能會產生。

DbType和 SqlDbType 屬性都可以藉由設定 Value 來推斷。

屬性 Value 會由 SqlDataAdapter.UpdateCommand覆寫。

如需串流的相關信息，請參閱 SqlClient 串流支援。

適用於

另請參閱