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 SqlDataAdaptertřídy . Tyto parametry slouží k výběru dat ze zdroje dat a jejich umístění do DataSet. Tento příklad předpokládá, že DataSet objekty a a SqlDataAdapter již byly vytvořeny 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 dědící 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ředpona SqlCommand třídy v System.Data.SqlClient oboru názvů .

Když dědíte z IDataParameter rozhraní, měli byste 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 Parameter třídy s názvem parametru a objekt, který je hodnotou parametru.
PrvParameter(název řetězce, PrvDbType dataType, velikost int)	Inicializuje novou instanci třídy Parameter s názvem parametru, datovým typem a šířkou.
PrvParameter(název řetězce, PrvDbType dataType, 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, Bajt precision, Byte scale, string srcColumn, DataRowVersion srcVersion, hodnota objektu)	Inicializuje novou instanci třídy s názvem parametru, datovým typem, šířkou, názvem zdrojového OleDbParameter 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 je parametr pouze vstup, pouze výstup, obousměrný nebo uložená procedura vrátit hodnotu parametru.
IsNullable	Získá hodnotu označující, zda parametr přijímá hodnoty null.
ParameterName	Získá nebo nastaví název objektu 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.