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 串流支援。

適用於

另請參閱