IDataParameter Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Představuje parametr objektu Command a volitelně jeho mapování na DataSet sloupce a je implementován zprostředkovateli dat .NET, kteří přistupují ke zdrojům dat.

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

Odvozené

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

Příklady

Následující příklad vytvoří více instancí odvozené třídy , SqlParameterprostřednictvím SqlParameterCollection kolekce v rámci SqlDataAdapter. Tyto parametry slouží k výběru dat ze zdroje dat a umístění dat do DataSet. V tomto příkladu se předpokládá, že DataSet již byly vytvořeny objekty a SqlDataAdapter s příslušným schématem, příkazy a připojením.

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

Poznámky

Rozhraní IDataParameter umožňuje zděděné třídě implementovat třídu Parameter, která představuje parametr objektu Command. Další informace o třídách parametrů najdete v tématu Konfigurace parametrů a datových typů parametrů.

Aplikace nevytvoří instanci IDataParameter rozhraní přímo, ale vytvoří instanci třídy, která dědí IDataParameter.

Třídy, které dědí IDataParameter , musí implementovat zděděné členy a obvykle definovat další členy pro přidání funkcí specifických pro zprostředkovatele. IDataParameter Například rozhraní definuje DbType vlastnost. Naopak OleDbParameter třída dědí tuto vlastnost a také definuje OleDbType vlastnost.

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .NET Framework, pojmenujte zděděnou třídu ve formátu Prv Parametr, kde Prv je jednotná předpona přidělená všem třídám v konkrétním oboru názvů zprostředkovatele dat rozhraní .NET Framework. Je například Sql předponou SqlCommand třídy v System.Data.SqlClient oboru názvů.

Při dědění z IDataParameter rozhraní byste měli implementovat následující konstruktory:

Položka	Popis
PrvParameter()	Inicializuje novou instanci třídy Parameter.
PrvParameter(název řetězce, PrvDbType dataType)	Inicializuje novou instanci třídy Parameter s názvem parametru a datovým typem.
PrvParameter(název řetězce, hodnota objektu)	Inicializuje novou instanci třídy Parameter s názvem parametru a objekt, který je hodnotou Parametr.
PrvParameter(název řetězce, Typ dat PrvDbType, velikost int)	Inicializuje novou instanci třídy Parameter s názvem parametru, datovým typem a šířkou.
PrvParameter(název řetězce, DataType PrvDbType, velikost int, řetězec srcColumn)	Inicializuje novou instanci DbParameter třídy s názvem parametru, datovým typem, šířkou a názvem zdrojového sloupce.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value)	Inicializuje novou instanci třídy s názvem parametru OleDbParameter , datovým typem, šířkou, názvem zdrojového sloupce, směrem parametru, přesností čísel a dalšími vlastnostmi.

Vlastnosti

DbType	Získá nebo nastaví DbType parametr.
Direction	Získá nebo nastaví hodnotu označující, zda parametr je pouze vstup, pouze výstup, obousměrný nebo uložená procedura vrácená hodnota parametru.
IsNullable	Získá hodnotu určující, zda parametr přijímá hodnoty null.
ParameterName	Získá nebo nastaví název IDataParameter.
SourceColumn	Získá nebo nastaví název zdrojového sloupce, který je mapován na DataSet a slouží k načtení nebo vrácení Value.
SourceVersion	Získá nebo nastaví na DataRowVersion použití při načítání Value.
Value	Získá nebo nastaví hodnotu parametru.