SqlParameter.Value 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得或設定參數的值。

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

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

屬性值

Object

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

實作

Value

屬性

TypeConverterAttribute

範例

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

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}

備註

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

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

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

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

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

屬性 Value 會由 SqlDataAdapter.UpdateCommand 覆寫。

如需串流的相關資訊，請參閱 SqlClient 串流支援。