DataSourceSelectArguments Classe

Définition

Fournit un mécanisme utilisé par les contrôles liés aux données pour demander aux contrôles de source de données d'exécuter des opérations liées aux données, lors de la récupération de données. Cette classe ne peut pas être héritée.

public ref class DataSourceSelectArguments sealed
public sealed class DataSourceSelectArguments
type DataSourceSelectArguments = class
Public NotInheritable Class DataSourceSelectArguments
Héritage
DataSourceSelectArguments

Remarques

Les contrôles liés aux données utilisent la DataSourceSelectArguments classe pour demander qu’un contrôle de source de données effectue des opérations supplémentaires liées aux données sur un jeu de résultats, telles que le tri des données ou le retour d’un sous-ensemble spécifique de données. Ces opérations liées aux données sont énumérées par l’énumération DataSourceCapabilities . Le tableau suivant indique comment la DataSourceSelectArguments classe prend en charge ces opérations liées aux données.

Fonctionnalité Propriétés DataSourceSelectArguments associées
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCount

Les contrôles liés aux données appellent explicitement la PerformSelect méthode pour lier des données, qui appelle la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode du contrôle de source de données auquel ils sont associés. De cette façon, le contrôle lié aux données récupère les données du contrôle de source de données à la demande. Étant donné que la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode accepte un DataSourceSelectArguments paramètre, le contrôle lié aux données est chargé de créer et de gérer un DataSourceSelectArguments objet et de le transmettre à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode lorsqu’il récupère des données du contrôle de source de données.

Dans certains cas, les contrôles liés aux données peuvent ne pas nécessiter de fonctionnalités supplémentaires liées aux données. Dans ce cas, les contrôles liés aux données passent un Empty objet arguments à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode .

Pour les jeux de résultats triés, les contrôles liés aux données case activée la propriété d’une vue de source de données au moment de l’exécution CanSort et ajoutent une DataSourceCapabilities.Sort fonctionnalité à l’aide de la AddSupportedCapabilities(DataSourceCapabilities) méthode . En tant qu’opération distincte, le contrôle lié aux données peut demander un jeu de résultats trié à partir d’un contrôle de source de données en définissant la SortExpression propriété sur l’objet DataSourceSelectArguments passé à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode .

Pour les scénarios de pagination, les contrôles liés aux données case activée la propriété d’une vue de source de données au moment de l’exécution CanPage et ajoutent une DataSourceCapabilities.Page fonctionnalité à l’aide de la AddSupportedCapabilities(DataSourceCapabilities) méthode . En tant qu’opération distincte, le contrôle lié aux données peut demander un sous-ensemble de données à partir d’un contrôle de source de données pour la pagination en définissant les StartRowIndex propriétés et MaximumRows sur l’objet DataSourceSelectArguments passé à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode .

Pour récupérer un nombre total de lignes pour les scénarios de pagination, les contrôles liés aux données case activée la propriété d’une vue de source de données au moment de l’exécution CanRetrieveTotalRowCount et ajoutez une DataSourceCapabilities.RetrieveTotalRowCount fonctionnalité à l’aide de la AddSupportedCapabilities(DataSourceCapabilities) méthode . En tant qu’opération distincte, le contrôle lié aux données peut demander un nombre total de lignes à partir d’un contrôle de source de données pour la pagination en définissant la RetrieveTotalRowCount propriété sur l’objet DataSourceSelectArguments passé à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode . Lorsque la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode retourne, le nombre total de lignes est contenu par la TotalRowCount propriété .

Important

Si l’une DataSourceSelectArguments des propriétés est définie, mais que le contrôle de source de données actuellement lié ne prend pas en charge la fonctionnalité demandée, une InvalidOperationException exception est levée lorsque la DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) méthode est appelée.

Constructeurs

DataSourceSelectArguments()

Initialise une nouvelle instance par défaut de la classe DataSourceSelectArguments.

DataSourceSelectArguments(Int32, Int32)

Initialise une nouvelle instance de la classe DataSourceSelectArguments avec la position de départ spécifiée et le nombre de lignes à retourner pour les scénarios de pagination.

DataSourceSelectArguments(String)

Initialise une nouvelle instance de la classe DataSourceSelectArguments avec l'expression de tri spécifiée.

DataSourceSelectArguments(String, Int32, Int32)

Initialise une nouvelle instance de la classe DataSourceSelectArguments avec l'expression de tri spécifiée, la position de départ et le nombre de lignes à retourner pour des scénarios de pagination.

Propriétés

Empty

Obtient un objet DataSourceSelectArguments dont la valeur de l'expression de tri est Empty.

MaximumRows

Obtient ou définit une valeur qui représente le nombre maximal de lignes de données qu'un contrôle de source de données retourne lors d'une opération de récupération de données.

RetrieveTotalRowCount

Obtient ou définit une valeur qui indique si un contrôle de source de données doit récupérer toutes les lignes de données lors d'une opération de récupération de données.

SortExpression

Obtient ou définit une expression utilisée par l'affichage de source de données pour trier les données récupérées par la méthode Select(DataSourceSelectArguments, DataSourceViewSelectCallback).

StartRowIndex

Obtient ou définit une valeur qui représente la position de départ devant être utilisée par le contrôle de source de données pour récupérer des lignes de données lors d'une opération de récupération de données.

TotalRowCount

Obtient ou définit le nombre de lignes récupérées lors d'une opération de récupération de données.

Méthodes

AddSupportedCapabilities(DataSourceCapabilities)

Ajoute une fonction à l'instance de DataSourceSelectArguments qui est utilisée pour comparer des fonctions prises en charge et des fonctions demandées.

Equals(Object)

Détermine si l'instance spécifiée DataSourceSelectArguments équivaut à l'instance actuelle.

GetHashCode()

Retourne le code de hachage pour le type DataSourceSelectArguments.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Compare les fonctions demandées pour une opération ExecuteSelect(DataSourceSelectArguments) par rapport à celles prises en charge par l'affichage de source de données spécifié.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi