IDataParameter 介面

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

代表 Command 物件的參數，以及其與 DataSet 資料行的對應 (選擇性)；而且是由存取資料來源的 .NET 資料提供者所實作。

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

衍生

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

範例

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

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

備註

IDataParameter介面可讓繼承類別實作Parameter類別，其代表 Command 物件的參數。 如需參數類別的詳細資訊，請參閱 設定參數和參數數據類型。

應用程式不會直接建立 介面的 IDataParameter 實例，但會建立繼承 IDataParameter之類別的實例。

繼承 IDataParameter 的類別必須實作繼承的成員，而且通常會定義其他成員以新增提供者特定的功能。 例如， IDataParameter 介面會 DbType 定義 屬性。 接著，類別 OleDbParameter 會繼承這個屬性，也會定義 OleDbType 屬性。

給實施者的注意事項

若要在 .NET Framework 數據提供者之間提升一致性，請在Parameter格式Prv中命名繼承類別，其中 Prv 是指定給特定 .NET Framework數據提供者命名空間中所有類別的統一前置詞。 例如，Sql是命名空間中 System.Data.SqlClient 類別的SqlCommand前置詞。

當您繼承自 介面時 IDataParameter ，應該實作下列建構函式：

項目	描述
PrvParameter ()	初始化 Parameter 類別的新實例。
PrvParameter (字串名稱、PrvDbType dataType)	使用參數名稱和數據類型，初始化Parameter類別的新實例。
PrvParameter (字串名稱、物件值)	使用參數名稱和參數值的物件，初始化 Parameter 類別的新實例。
PrvParameter (字串名稱、PrvDbType dataType、int size)	使用參數名稱、數據類型和寬度，初始化Parameter類別的新實例。
PrvParameter (字串名稱、PrvDbType dataType、int size、string srcColumn)	使用參數名稱、數據類型、寬度和源數據行名稱，初始化 DbParameter 類別的新實例。
PrvParameter (string parameterName， PrvDbType dbType， int size， ParameterDirection direction， Boolean isNullable， Byte precision， Byte scale， string srcColumn， DataRowVersion srcVersion， object value)	使用參數名稱、數據類型、寬度、源數據行名稱、參數方向、數值有效位數和其他屬性，初始化 類別的新實例 OleDbParameter 。

屬性

DbType	取得或設定參數的 DbType。
Direction	取得或設定值，表示參數是僅限輸入、僅限輸出、雙向或預存程序傳回值參數。
IsNullable	取得值，這個值指出參數是否接受 Null 值。
ParameterName	取得或設定 IDataParameter 的名稱。
SourceColumn	取得或設定來源資料行的名稱，其對應至 DataSet 並用於載入或傳回 Value。
SourceVersion	取得或設定 DataRowVersion，以在載入 Value 時使用。
Value	取得或設定參數的值。