IDataParameter IDataParameter IDataParameter IDataParameter Interface

Definizione

Rappresenta un parametro per un oggetto Command ed eventualmente il relativo mapping a colonne DataSet e viene implementata dai provider di dati .NET Framework che accedono a database relazionali.Represents a parameter to a Command object, and optionally, its mapping to DataSet columns; and is implemented by .NET Framework data providers that access data sources.

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

Esempi

L'esempio seguente crea più istanze della classe derivata, SqlParameter, tramite il SqlParameterCollection insieme all'interno di SqlDataAdapter.The following example creates multiple instances of the derived class, SqlParameter, through the SqlParameterCollection collection within the SqlDataAdapter. Questi parametri vengono utilizzati per selezionare dati dall'origine dati e inserire i dati nel DataSet.These parameters are used to select data from the data source and place the data in the DataSet. Questo esempio si presuppone che un DataSet e un SqlDataAdapter sono già stati creati con lo schema appropriato, comandi e connessione.This example assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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

Il IDataParameter interfaccia consente a una classe che eredita implementare una classe di parametri, che rappresenta un parametro a un oggetto comando.The IDataParameter interface allows an inheriting class to implement a Parameter class, which represents a parameter to a Command object. Per altre informazioni sulle classi di parametri, vedere configurazione dei parametri e tipi di dati di parametro.For more information about Parameter classes, see Configuring Parameters and Parameter Data Types.

Un'applicazione non crea un'istanza di IDataParameter interfaccia direttamente, ma crea un'istanza di una classe che eredita IDataParameter.An application does not create an instance of the IDataParameter interface directly, but creates an instance of a class that inherits IDataParameter.

Le classi che ereditano IDataParameter deve implementare i membri ereditati e in genere definisce membri aggiuntivi per aggiungere funzionalità specifiche del provider.Classes that inherit IDataParameter must implement the inherited members, and typically define additional members to add provider-specific functionality. Ad esempio, il IDataParameter interfaccia definisce il DbType proprietà.For example, the IDataParameter interface defines the DbType property. A sua volta, il OleDbParameter classe di questa proprietà viene ereditata e definisce anche il OleDbType proprietà.In turn, the OleDbParameter class inherits this property, and also defines the OleDbType property.

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, assegnare un nome alla classe che eredita il form Prv parametro in cui Prv è il prefisso uniform assegnato a tutte le classi in uno specifico spazio dei nomi provider di dati .NET Framework.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv Parameter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Ad esempio, Sql è il prefisso del SqlCommand classe la System.Data.SqlClient dello spazio dei nomi.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Quando si eredita dal IDataParameter interfaccia, è necessario implementare i costruttori seguenti:When you inherit from the IDataParameter interface, you should implement the following constructors:

ElementoItem DescrizioneDescription
PrvParameter()PrvParameter() Inizializza una nuova istanza della classe di parametri.Initializes a new instance of the Parameter class.

PrvParameter (stringa nome, tipo di dati PrvDbType)PrvParameter(string name, PrvDbType dataType) Inizializza una nuova istanza della classe parametro con il tipo di dati e nome del parametro.Initializes a new instance of the Parameter class with the parameter name and data type.

PrvParameter (nome della stringa, valore dell'oggetto)PrvParameter(string name, object value) Inizializza una nuova istanza della classe parametro con il nome del parametro e un oggetto che rappresenta il valore del parametro.Initializes a new instance of the Parameter class with the parameter name and an object that is the value of the Parameter.

PrvParameter (nome della stringa, PrvDbType dataType, le dimensioni di int)PrvParameter(string name, PrvDbType dataType, int size) Inizializza una nuova istanza della classe parametro con il nome del parametro, tipo di dati e larghezza.Initializes a new instance of the Parameter class with the parameter name, data type, and width.

PrvParameter (nome della stringa, dataType PrvDbType, dimensioni int, stringa srcColumn)PrvParameter(string name, PrvDbType dataType, int size, string srcColumn) Inizializza una nuova istanza della classe DbParameter con il nome del parametro, tipo di dati, larghezza e il nome di colonna di origine.Initializes a new instance of the DbParameter class with the parameter name, data type, width, and source column name.

PrvParameter (stringa parameterName PrvDbType dbType, dimensioni int, ParameterDirection direzione, isNullable booleano, Byte mobile e precisione, scala Byte, stringa srcColumn, srcVersion DataRowVersion valore dell'oggetto)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 di OleDbParameter classe con il nome del parametro, tipo di dati, la larghezza, il nome di colonna di origine, la direzione del parametro, la precisione numerica e altre proprietà.Initializes a new instance of the OleDbParameter class with the parameter name, data type, width, source column name, parameter direction, numeric precision, and other properties.

Proprietà

DbType DbType DbType DbType

Ottiene o imposta l'oggetto DbType del parametro.Gets or sets the DbType of the parameter.

Direction Direction Direction 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.Gets or sets a value indicating whether the parameter is input-only, output-only, bidirectional, or a stored procedure return value parameter.

IsNullable IsNullable IsNullable IsNullable

Ottiene un valore che indica se il parametro ammette valori Null.Gets a value indicating whether the parameter accepts null values.

ParameterName ParameterName ParameterName ParameterName

Ottiene o imposta il nome di IDataParameter.Gets or sets the name of the IDataParameter.

SourceColumn SourceColumn SourceColumn SourceColumn

Ottiene o imposta il nome della colonna di origine mappata a DataSet e usata per caricare o restituire Value.Gets or sets the name of the source column that is mapped to the DataSet and used for loading or returning the Value.

SourceVersion SourceVersion SourceVersion SourceVersion

Ottiene o imposta l'oggetto DataRowVersion da usare durante il caricamento di Value.Gets or sets the DataRowVersion to use when loading Value.

Value Value Value Value

Ottiene o imposta il valore del parametro.Gets or sets the value of the parameter.

Si applica a