DataSourceSelectArguments.MaximumRows Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
public:
property int MaximumRows { int get(); void set(int value); };public int MaximumRows { get; set; }member this.MaximumRows : int with get, setPublic Property MaximumRows As IntegerValeur de propriété
Nombre maximal de lignes de données qu'une source de données retourne lors d'une opération de récupération de données. La valeur par défaut est 0, ce qui indique que toutes les lignes de données possibles ont été retournées.
Remarques
La MaximumRows propriété prend en charge les scénarios de pagination. Les contrôles liés aux données vérifient la propriété d’une vue de source de données CanPage au moment de l’exécution et ajoutent une DataSourceCapabilities.Page fonctionnalité à l’aide de la AddSupportedCapabilities(DataSourceCapabilities) méthode si la vue prend en charge la pagination. Si le contrôle lié aux données ne peut pas ajouter la fonctionnalité et que les propriétés de pagination sont définies sur un DataSourceSelectArguments objet passé à la vue de source de données pendant une opération de récupération de données, une InvalidOperationException exception peut être levée.
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 MaximumRows Propriétés et sur l' DataSourceSelectArguments objet passé à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode.
Important
Si l’une des DataSourceSelectArguments 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.