SqlParameter 類別

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

代表 SqlCommand 的參數，並選擇性地代表其對於 DataSet 資料行的對應。 此類別無法獲得繼承。 如需參數的詳細資訊，請參閱設定參數和參數資料類型。

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

範例

下列範例會在 內透過 SqlParameterCollection 集合建立的SqlDataAdapter多個實例SqlParameter。 這些參數可用來從數據源中選取數據，並將數據 DataSet放入 中。 這個範例假設 DataSet 已使用適當的架構、命令和連線來建立 和 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

備註

參數名稱不區分大小寫。

注意

.NET Framework Data Provider for SQL Server 不支援無名稱，也稱為序數參數。

如需詳細資訊，以及示範如何使用參數的其他範例程序代碼，請參閱 命令和參數。

建構函式

SqlParameter()	初始化 SqlParameter 類別的新執行個體。
SqlParameter(String, Object)	初始化 SqlParameter 類別的新執行個體，這個執行個體會使用新 SqlParameter 的參數名稱和值。
SqlParameter(String, SqlDbType)	初始化 SqlParameter 類別的新執行個體，這個執行個體會使用參數名稱和資料類型。
SqlParameter(String, SqlDbType, Int32)	初始化 SqlParameter 類別的新執行個體，這個執行個體會使用參數名稱、SqlDbType 和此大小。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化 SqlParameter 類別的新執行個體，這個執行個體會使用參數名稱、參數類型、參數大小、ParameterDirection、參數精確度、參數比例、來源資料行、要使用的 DataRowVersion 和參數值。
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、大小和來源資料行名稱。

屬性

CompareInfo	取得或設定 CompareInfo 物件，其定義應當如何為這個參數執行字串比較。
DbType	取得或設定參數的 SqlDbType。
Direction	取得或設定值，以表示參數是僅限輸入、僅限輸出、雙向 (Bidirectional) 或預存程序 (Stored Procedure) 傳回值參數。
ForceColumnEncryption	使用 Always Encrypted 時，會強制加密參數。 如果 SQL Server 向驅動程式告知參數不需要加密，使用該參數的查詢就會失敗。 此屬性會針對受到安全性攻擊危害的 SQL Server 提供額外的保護，此類 SQL Server 會將不正確的加密中繼資料提供給用戶端，而可能導致資料洩露。
IsNullable	取得或設定值，這個值指出該參數是否接受 null 值。 IsNullable 不會用來驗證參數的值，也不會在執行命令時阻止傳送或接收 Null 值。
LocaleId	取得或設定地區設定識別碼，其決定特定地區的慣例和語言。
Offset	取得或設定 Value 屬性的位移。
ParameterName	取得或設定 SqlParameter 的名稱。
Precision	取得或設定用來表示 Value 屬性的最大位數。
Scale	取得或設定 Value 所解析的小數點位數。
Size	取得或設定資料行中資料的最大大小 (以位元組為單位)。
SourceColumn	取得或設定來源資料行的名稱，這個資料行對應至 DataSet，並用來載入或傳回 Value。
SourceColumnNullMapping	取得或設定值，這個值表示來源資料行是否可為 Null。 這可讓 SqlCommandBuilder 正確產生可為 Null 的資料行的 Update 陳述式。
SourceVersion	取得或設定載入 DataRowVersion 時要使用的 Value。
SqlDbType	取得或設定參數的 SqlDbType。
SqlValue	取得或設定參數的值做為 SQL 類型。
TypeName	取得或設定資料表值參數的類型名稱。
UdtTypeName	取得或設定 string，表示使用者定義類型做為參數。
Value	取得或設定參數的值。
XmlSchemaCollectionDatabase	取得這個 XML 執行個體結構描述集合所在的資料庫名稱。
XmlSchemaCollectionName	取得這個 XML 執行個體的結構描述集合名稱。
XmlSchemaCollectionOwningSchema	這個 XML 執行個體結構描述集合所在的主控關聯式結構描述。

方法

CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
ResetDbType()	重設與此 SqlParameter 相關聯的類型。
ResetSqlDbType()	重設與此 SqlParameter 相關聯的類型。
ToString()	取得包含 ParameterName 的字串。

明確介面實作

ICloneable.Clone()	如需這個成員的說明，請參閱 Clone()。
IDbDataParameter.Precision	表示數值參數的整數位數。 (繼承來源 DbParameter)
IDbDataParameter.Scale	如需這個成員的說明，請參閱 Scale。 (繼承來源 DbParameter)

另請參閱

• SqlParameterCollection
• SqlCommand
• 命令和參數
• DataAdapter 的參數
• SQL Server and ADO.NET (SQL Server 和 ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)