IDataParameter Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDataParameter.cs

Představuje parametr objektu Command a volitelně jeho mapování na DataSet sloupce a je implementováno 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 objektu DataSet. V tomto příkladu se předpokládá, že již DataSet byla vytvořena a SqlDataAdapter má odpovídající schéma, příkazy a připojení.

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ěnou třídu implementovat třídu Parameter, která představuje parametr objektu Command. Další informace o třídách parametrů naleznete 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í, musí implementovat zděděné IDataParameter členy a obvykle definují další členy pro přidání funkcí specifických pro zprostředkovatele. IDataParameter Například rozhraní definuje DbType vlastnost. Třída zase OleDbParameter 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ění třídy v parametru formuláře Prv , kde Prv je uniformní předpona udělená všem třídám v konkrétním oboru názvů zprostředkovatele dat rozhraní .NET Framework. Například Sql je předpona 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, DatovýType PrvDbType)	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, DatovýType PrvDbType, velikost int)	Inicializuje novou instanci třídy Parameter s názvem parametru, datovým typem a šířkou.
PrvParameter(název řetězce, DatovýType PrvDbType, int size, string 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, hodnota objektu)	Inicializuje novou instanci třídy s názvem parametru OleDbParameter , datovým typem, šířkou, názvem zdrojového sloupce, směr parametru, číselnou přesností a dalšími vlastnostmi.

Vlastnosti

Name	Description
DbType	Získá nebo nastaví DbType parametr.
Direction	Získá nebo nastaví hodnotu určující, zda je parametr pouze vstup, výstup-pouze, obousměrný nebo uložená procedura vrácená hodnota parametr.
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 namapován na DataSet a používá se k načtení nebo vrácení Value.
SourceVersion	Získá nebo nastaví DataRowVersion použití při načítání Value.
Value	Získá nebo nastaví hodnotu parametru.