SqlParameter 類別

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表一個參數到 a SqlCommand ，並可選擇地將其映射到 DataSet 欄位。此類別無法獲得繼承。欲了解更多參數資訊，請參閱「參數配置與參數資料型別」。

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

繼承: Object

MarshalByRefObject
SqlParameter

繼承: Object

MarshalByRefObject

DbParameter
SqlParameter

屬性: TypeConverterAttribute

實作: IDataParameter IDbDataParameter ICloneable

範例

以下範例透過集合在中SqlDataAdapter建立多個的SqlParameter SqlParameterCollection實例。這些參數用於從資料來源中選擇資料並將資料放入 DataSet。此範例假設 a DataSet 與 a SqlDataAdapter 已透過適當的結構、指令與連線建立。欲了解更多參數使用範例及資訊，請參閱在 ADO.NET及參數與參數資料類型配置。

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

備註

參數名稱不區分大小寫。

Note

無名（又稱序數）參數不被 .NET Framework 資料提供者支援。

欲了解更多資訊及示範如何使用參數的範例程式碼，請參閱指令與參數。

建構函式

名稱	Description
SqlParameter()	初始化 SqlParameter 類別的新執行個體。
SqlParameter(String, Object)	初始化一個使用參數名稱及新SqlParameter值的類別新實例SqlParameter。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、參數型別、參數大小、a ParameterDirection、參數的精度、參數的縮放、來源欄位、 DataRowVersion a to use 以及參數值。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	初始化一個新的類別實例，該實例 SqlParameter 使用參數名稱、參數型別、參數長度、方向、精確度、縮放、來源欄位名稱、其中一個 DataRowVersion 值、用於原始欄位映射的布林值、 `SqlParameter`該 XML 實例結構集合所在資料庫名稱，擁有該 XML 實例的結構集合所在的關聯式結構，以及該參數的結構集合名稱。
SqlParameter(String, SqlDbType, Int32, String)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、大小 SqlDbType及來源欄位名稱。
SqlParameter(String, SqlDbType, Int32)	初始化一個使用參數名稱、參數 SqlDbType、與大小的類別新實例SqlParameter。
SqlParameter(String, SqlDbType)	初始化使用參數名稱與資料型態的新類別實例 SqlParameter 。

屬性

名稱	Description
CompareInfo	取得或設定 CompareInfo 定義該參數字串比較方式的物件。
DbType	取得或設定參數的。SqlDbType
Direction	取得或設定一個值，指示參數是僅輸入、僅輸出、雙向，或是儲存程序回傳值參數。
ForceColumnEncryption	在使用 Always Encrypted 時，會強制加密參數。如果 SQL Server 告知驅動程式該參數不需要加密，使用該參數的查詢將會失敗。此特性可額外防護因 SQL Server 遭入侵而提供錯誤加密元資料給用戶端，可能導致資料外洩的安全攻擊。
IsNullable	取得或設定一個值，指示參數是否接受空值。 IsNullable 不用於驗證參數值，且執行指令時不會阻止傳送或接收空值。
LocaleId	取得或設定區域識別碼，決定特定區域的慣例與語言。
Offset	取得或設定偏移量到該 Value 屬性。
ParameterName	取得或設定的名稱。SqlParameter
Precision	取得或設定用來表示 Value 該屬性的最大位數。
Scale	取得或設定被解決的小 Value 數點數。
Size	取得或設定欄位內資料的最大大小（以位元組為單位）。
SourceColumn	取得或設定映射到的DataSet來源欄位名稱，並用於載入或返回。Value
SourceColumnNullMapping	取得或設定一個值，指示來源欄位是否可為空。這能正確 SqlCommandBuilder 地為可空欄位產生 Update 語句。
SourceVersion	當你載入Value時，會取得或設定DataRowVersion要使用的。
SqlDbType	取得或設定參數的。SqlDbType
SqlValue	取得或設定參數值為 SQL 型別。
TypeName	取得或設定表值參數的型別名稱。
UdtTypeName	取得或設定一個 `string` 代表使用者定義型態的參數。
Value	取得或設定參數的值。
XmlSchemaCollectionDatabase	取得該 XML 實例結構集合所在資料庫名稱。
XmlSchemaCollectionName	取得此 XML 實例的結構集合名稱。
XmlSchemaCollectionOwningSchema	擁有此 XML 實例的結構集合所在的關聯結構。

方法

名稱	Description
CreateObjRef(Type)	建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。 (繼承來源 MarshalByRefObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得一個終身服務物件以控制此實例的終身政策。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立一個 MarshalByRefObject 目前物件的淺層複製品。 (繼承來源 MarshalByRefObject)
ResetDbType()	重置與此 SqlParameter相關聯的型別。
ResetSqlDbType()	重置與此 SqlParameter相關聯的型別。
ToString()	得到包含 ParameterName的字串。

明確介面實作

名稱	Description
ICloneable.Clone()	關於此成員的描述，請參見 Clone()。
IDbDataParameter.Precision	表示數值參數的精度。 (繼承來源 DbParameter)
IDbDataParameter.Scale	關於此成員的描述，請參見 Scale。 (繼承來源 DbParameter)

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？