Paramètres et DataAdapter DB2

La DataAdapter classe a quatre propriétés qui sont utilisées pour récupérer des données à partir de et mettre à jour les données vers la source de données : la SelectCommand propriété retourne des données de la source de données ; les InsertCommandpropriétés , UpdateCommandet DeleteCommand sont utilisées pour gérer les modifications au niveau de la source de données. Vous devez définir la SelectCommand propriété avant d’appeler la Fill méthode de l’objet DataAdapter . Les propriétés InsertCommand, UpdateCommand ou DeleteCommand doivent être définies avant que la méthode Update du DataAdapter ne soit appelée, en fonction des modifications qui ont été apportées aux données dans le DataSet. Par exemple, si des lignes ont été ajoutées, vous devez définir la InsertCommand propriété avant d’appeler la Update méthode. Lorsque Update traite une ligne insérée, mise à jour ou supprimée, l’objet DataAdapter utilise la propriété correspondante Command pour traiter l’action. Les informations actuelles concernant la ligne modifiée sont passées à l’objet Command par le biais de la collection Parameters.

Lorsque vous mettez à jour une ligne au niveau de la source de données, vous appelez l’instruction UPDATE, qui utilise un identificateur unique pour identifier la ligne dans la table à mettre à jour. L’identificateur unique est généralement la valeur d’un champ de clé primaire. L’instruction UPDATE utilise des paramètres qui contiennent à la fois l’identificateur unique et les colonnes et valeurs à mettre à jour.

La spécification du Parameter type convertit la valeur du paramètre en Fournisseur managé pour DB2 avant de passer la valeur à la source de données. Vous pouvez également spécifier le type d’un Parameter de manière générique en définissant la DbType propriété de l’objet Parameter sur un particulier DbType.

Valeurs d’énumération ParameterDirection

Le tableau suivant montre les valeurs que vous pouvez utiliser avec l’énumération ParameterDirection pour définir le Direction de .Parameter

Nom du membre	Description
Entrée	Le paramètre est un paramètre d'entrée. Il s’agit de la valeur par défaut.
InputOutput	Le paramètre est à la fois un paramètre d’entrée et un paramètre de sortie.
Output	Le paramètre est un paramètre de sortie.
ReturnValue	Le paramètre représente une valeur de retour.

SourceColumnet SourceVersion peuvent être passés en tant qu’arguments au Parameter constructeur ou définis en tant que propriétés d’un .Parameter SourceColumn est le nom du DataColumn à partir duquel DataRow la valeur de est Parameter récupérée. spécifie SourceVersion la version que DataRow le DataAdapter utilise pour récupérer la valeur.

Valeurs d’énumération DataRowVersion

Le tableau suivant présente les valeurs d'énumération DataRowVersion disponibles pour être utilisées avec SourceVersion.

Nom du membre	Description
Actuel	Le paramètre utilise la valeur actuelle de la colonne. Il s’agit de la valeur par défaut.
Default	Le paramètre utilise la valeur DefaultValue de la colonne.
Original	Le paramètre utilise la valeur d'origine de la colonne.
Proposed	Le paramètre utilise une valeur proposée.

Vous pouvez contrôler la façon dont les valeurs retournées par la source de données sont mappées à l’objet à l’aide DataSet de la UpdatedRowSource propriété de l’objet Command . En définissant la propriété sur l’une UpdatedRowSource des valeurs d’énumération UpdateRowSource , vous pouvez contrôler si les paramètres retournés par la DataAdapter commande sont ignorés ou appliqués à la ligne modifiée dans l’objet DataSet . Vous pouvez également spécifier si la première ligne retournée (si elle existe) est appliquée à la ligne modifiée dans l’objet DataSet .

Valeurs d’énumération UpdateRowSource

Le tableau suivant décrit les différentes valeurs de l’énumération et la UpdateRowSource façon dont elles affectent le comportement d’une commande utilisée avec un DataAdapter objet.

Nom du membre	Description
Les deux	Les paramètres de sortie et la première ligne d’un jeu de résultats retourné peuvent être mappés à la ligne modifiée dans .DataSet
ReturnedFirstRecord	Seules les données de la première ligne d’un jeu de résultats retourné peuvent être mappées à la ligne modifiée dans .DataSet
None	Les paramètres de sortie ou les lignes d'un jeu de résultats retourné sont ignorés.
OutputParameters	Seuls les paramètres de sortie peuvent être mappés à la ligne modifiée dans le DataSet.

Voir aussi

Utilisation de DataAdapter et de DataSet pour une base de données DB2