SqlParameter 類別

參考

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.SqlClient.dll

組件:: System.Data.dll

重要

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

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

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

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

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

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

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

public sealed class SqlParameter : System.Data.Common.DbParameter

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

[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter
    interface ICloneable

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

type SqlParameter = class
    inherit DbParameter

[<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

[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

繼承: Object

DbParameter
SqlParameter

繼承: Object

MarshalByRefObject

DbParameter
SqlParameter

繼承: Object

MarshalByRefObject
SqlParameter

屬性: TypeConverterAttribute

實作: ICloneable IDataParameter IDbDataParameter

範例

下列範例會透過內的集合，建立 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

備註

參數名稱不區分大小寫。

注意

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

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

建構函式

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。
SourceVersion	取得或設定載入 DataRowVersion 時要使用的 Value。 (繼承來源 DbParameter)
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()。
IDataParameter.SourceVersion	取得或設定 DataRowVersion，以在載入 Value 時使用。 (繼承來源 DbParameter)
IDbDataParameter.Precision	表示數值參數的整數位數。 (繼承來源 DbParameter)
IDbDataParameter.Scale	如需這個成員的說明，請參閱 Scale。 (繼承來源 DbParameter)

適用於

SqlParameter 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

其他資源