SqlParameter 類別

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

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

新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

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

[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.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

繼承

Object

MarshalByRefObject

DbParameter

SqlParameter

屬性

TypeConverterAttribute

實作

IDataParameter IDbDataParameter ICloneable

範例

以下範例透過集合在 中SqlParameter建立多個 的SqlParameterCollectionSqlDataAdapter實例。 這些參數用於從資料來源中選擇資料並將資料放入 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 類別的新執行個體。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, Object)	初始化一個使用參數名稱及新SqlParameter值的類別新實例SqlParameter。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、參數型別、參數大小、a ParameterDirection、參數的精度、參數的縮放、來源欄位、 DataRowVersion a to use 以及參數值。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	初始化一個新的類別實例，該實例 SqlParameter 使用參數名稱、參數型別、參數長度、方向、精確度、縮放、來源欄位名稱、其中一個 DataRowVersion 值、用於原始欄位映射的布林值、 SqlParameter該 XML 實例結構集合所在資料庫名稱， 擁有該 XML 實例的結構集合所在的關聯式結構，以及該參數的結構集合名稱。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, SqlDbType, Int32, String)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、大小 SqlDbType及來源欄位名稱。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, SqlDbType, Int32)	初始化一個使用參數名稱、參數 SqlParameter、 與大小的類別新實例SqlDbType。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
SqlParameter(String, SqlDbType)	初始化使用參數名稱與資料型態的新類別實例 SqlParameter 。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

屬性

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

方法

名稱	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相關聯的型別。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
ResetSqlDbType()	重置與此 SqlParameter相關聯的型別。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
ToString()	得到包含 ParameterName的字串。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

明確介面實作

名稱	Description
ICloneable.Clone()	關於此成員的描述，請參見 Clone()。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
IDbDataParameter.Precision	表示數值參數的精度。 (繼承來源 DbParameter)
IDbDataParameter.Scale	關於此成員的描述，請參見 Scale。 (繼承來源 DbParameter)

另請參閱

• SqlParameterCollection
• SqlCommand
• 命令和參數
• DataAdapter 參數
• SQL Server 和 ADO.NET
• ADO.NET 概觀