IDataParameter Interfaccia

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

Nell'esempio seguente vengono create più istanze della classe derivata, SqlParameter, tramite la SqlParameterCollection raccolta all'interno SqlDataAdapterdi.The following example creates multiple instances of the derived class, SqlParameter, through the SqlParameterCollection collection within the SqlDataAdapter. Questi parametri vengono utilizzati per selezionare i dati dall'origine dati e inserire i dati in DataSet.These parameters are used to select data from the data source and place the data in the DataSet. In questo esempio si presuppone DataSet che un SqlDataAdapter oggetto e un oggetto siano già stati creati con lo schema, i comandi e la connessione appropriati.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

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

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

Le classi che IDataParameter ereditano devono implementare i membri ereditati e in genere definiscono 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, l' IDataParameter interfaccia definisce la DbType proprietà.For example, the IDataParameter interface defines the DbType property. A sua volta, OleDbParameter la classe eredita questa proprietà e definisce anche la 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 .NET Framework provider di dati, denominare la classe che Prv eredita nel Prv parametro form, dove è il prefisso uniforme assegnato a tutte le classi in uno specifico spazio dei nomi del 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 SqlCommand della classe nello System.Data.SqlClient spazio dei nomi.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

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

ElementoItem DescriptionDescription
PrvParameter()PrvParameter() Inizializza una nuova istanza della classe Parameter.Initializes a new instance of the Parameter class.
PrvParameter (nome stringa, tipo di dati PrvDbType)PrvParameter(string name, PrvDbType dataType) Inizializza una nuova istanza della classe Parameter con il nome del parametro e il tipo di dati.Initializes a new instance of the Parameter class with the parameter name and data type.
PrvParameter (nome stringa, valore oggetto)PrvParameter(string name, object value) Inizializza una nuova istanza della classe Parameter 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 stringa, tipo di dati PrvDbType, dimensioni int)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.Initializes a new instance of the Parameter class with the parameter name, data type, and width.
PrvParameter (nome stringa, tipo di dati PrvDbType, dimensione int, stringa srcColumn)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.Initializes a new instance of the DbParameter class with the parameter name, data type, width, and source column name.
PrvParameter (String parameterName, PrvDbType dbType, int size, ParameterDirection Direction, Boolean isNullable, byte Precision, byte scale, String srcColumn, DataRowVersion srcVersion, Object value)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à.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

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

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

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

ParameterName

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

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

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

Value

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

Si applica a