IDataParameter Interfaccia

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Rappresenta un parametro per un oggetto Command ed eventualmente il relativo mapping a colonne DataSet e viene implementata dai provider di dati .NET che accedono a database relazionali.

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

Derivato

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

Esempio

Nell'esempio seguente vengono create più istanze della classe derivata, , SqlParametertramite la SqlParameterCollection raccolta all'interno di SqlDataAdapter. Questi parametri vengono usati per selezionare i dati dall'origine dati e inserire i dati in DataSet. In questo esempio si presuppone che sia già stato creato un oggetto DataSet e SqlDataAdapter con lo schema, i comandi e la connessione appropriati.

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

Commenti

L'interfaccia IDataParameter consente a una classe che eredita di implementare una classe Parameter, che rappresenta un parametro per un oggetto Command. Per altre informazioni sulle classi parameter, vedere Configuring Parameters and Parameter Data Types.

Un'applicazione non crea direttamente un'istanza dell'interfaccia IDataParameter , ma crea un'istanza di una classe che eredita IDataParameter.

Le classi che ereditano IDataParameter devono implementare i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IDataParameter definisce la DbType proprietà . A sua volta, la OleDbParameter classe eredita questa proprietà e definisce anche la OleDbType proprietà .

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, denominare la classe che eredita nel formato Prv Parametro dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi del provider di dati .NET Framework specifico. Ad esempio, Sql è il prefisso della SqlCommand classe nello spazio dei System.Data.SqlClient nomi .

Quando si eredita dall'interfaccia IDataParameter , è necessario implementare i costruttori seguenti:

Elemento	Descrizione
PrvParameter()	Inizializza una nuova istanza della classe Parameter.
PrvParameter(string name, PrvDbType dataType)	Inizializza una nuova istanza della classe Parameter con il nome del parametro e il tipo di dati.
PrvParameter(string name, object value)	Inizializza una nuova istanza della classe Parameter con il nome del parametro e un oggetto che rappresenta il valore di Parameter.
PrvParameter(string name, PrvDbType dataType, int size)	Inizializza una nuova istanza della classe Parameter con il nome del parametro, il tipo di dati e la larghezza.
PrvParameter(string name, PrvDbType dataType, int size, string srcColumn)	Inizializza una nuova istanza della classe DbParameter con il nome del parametro, il tipo di dati, la larghezza e il nome della colonna di origine.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value)	Inizializza una nuova istanza della OleDbParameter classe con il nome del parametro, il tipo di dati, la larghezza, il nome della colonna di origine, la direzione del parametro, la precisione numerica e altre proprietà.

Proprietà

DbType	Ottiene o imposta l'oggetto DbType del parametro.
Direction	Ottiene o imposta un valore che indica se il parametro è di solo input, di solo output, bidirezionale o un parametro di un valore restituito da una stored procedure.
IsNullable	Ottiene un valore che indica se il parametro ammette valori Null.
ParameterName	Ottiene o imposta il nome di IDataParameter.
SourceColumn	Ottiene o imposta il nome della colonna di origine mappata a DataSet e usata per caricare o restituire Value.
SourceVersion	Ottiene o imposta l'oggetto DataRowVersion da usare durante il caricamento di Value.
Value	Ottiene o imposta il valore del parametro.