IDataParameter Interface

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Vertegenwoordigt een parameter voor een opdrachtobject en optioneel de toewijzing aan DataSet kolommen; en wordt geïmplementeerd door .NET gegevensproviders die toegang hebben tot gegevensbronnen.

public interface class IDataParameter
public interface IDataParameter
type IDataParameter = interface
Public Interface IDataParameter
Afgeleid

Voorbeelden

In het volgende voorbeeld worden meerdere exemplaren van de afgeleide klasse gemaakt, SqlParametervia de SqlParameterCollection verzameling in de SqlDataAdapter. Deze parameters worden gebruikt voor het selecteren van gegevens uit de gegevensbron en het plaatsen van de gegevens in de DataSet. In dit voorbeeld wordt ervan uitgegaan dat een DataSet en een SqlDataAdapter al zijn gemaakt met het juiste schema, opdrachten en verbinding.

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

Opmerkingen

Met de IDataParameter interface kan een overnemende klasse een parameterklasse implementeren. Deze klasse vertegenwoordigt een parameter voor een opdrachtobject. Zie Parameters en parametergegevenstypen configureren voor meer informatie over parameterklassen.

Een toepassing maakt geen exemplaar van de IDataParameter interface rechtstreeks, maar maakt een exemplaar van een klasse die wordt overgenomen IDataParameter.

Klassen die overnemen IDataParameter , moeten de overgenomen leden implementeren en definiëren doorgaans extra leden om providerspecifieke functionaliteit toe te voegen. De IDataParameter interface definieert bijvoorbeeld de DbType eigenschap. De klasse neemt deze eigenschap over OleDbParameter en definieert ook de OleDbType eigenschap.

Notities voor uitvoerders

Als u consistentie tussen .NET Framework-gegevensproviders wilt bevorderen, geeft u de overnemende klasse een naam in de vorm Prv Parameter, waarbij Prv het uniforme voorvoegsel is dat wordt gegeven aan alle klassen in een specifieke .NET Framework-naamruimte voor de gegevensprovider. Is bijvoorbeeld Sql het voorvoegsel van de SqlCommand klasse in de System.Data.SqlClient naamruimte.

Wanneer u de IDataParameter interface over neemt, moet u de volgende constructors implementeren:

Artikel Beschrijving
PrvParameter() Initialiseert een nieuw exemplaar van de parameterklasse.
PrvParameter(tekenreeksnaam, PrvDbType-gegevenstype) Initialiseert een nieuw exemplaar van de parameterklasse met de parameternaam en het gegevenstype.
PrvParameter(tekenreeksnaam, objectwaarde) Initialiseert een nieuw exemplaar van de parameterklasse met de parameternaam en een object dat de waarde van de parameter is.
PrvParameter(tekenreeksnaam, PrvDbType dataType, grootte int) Initialiseert een nieuw exemplaar van de parameterklasse met de parameternaam, het gegevenstype en de breedte.
PrvParameter(tekenreeksnaam, PrvDbType dataType, int size, string srcColumn) Initialiseert een nieuw exemplaar van de klasse DbParameter met de parameternaam, het gegevenstype, de breedte en de naam van de bronkolom.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value) Initialiseert een nieuw exemplaar van de OleDbParameter klasse met de parameternaam, het gegevenstype, de breedte, de naam van de bronkolom, de parameterrichting, de numerieke precisie en andere eigenschappen.

Eigenschappen

Name Description
DbType

Hiermee haalt u de DbType parameter op of stelt u deze in.
Direction

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de parameter alleen-invoer, alleen-uitvoer, bidirectioneel of een opgeslagen procedure retourwaardeparameter is.
IsNullable

Hiermee wordt een waarde opgehaald die aangeeft of de parameter null-waarden accepteert.
ParameterName

Hiermee haalt u de naam van de IDataParameter.
SourceColumn

Hiermee haalt u de naam op van de bronkolom die is toegewezen aan de DataSet en wordt gebruikt voor het laden of retourneren van de Valuekolom.
SourceVersion

Hiermee wordt het te gebruiken bij het DataRowVersion laden Valueopgevraagd of ingesteld.
Value

Hiermee haalt u de waarde van de parameter op of stelt u deze in.

Van toepassing op