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 retournées par un contrôle de source de données pour 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, set
Public Property MaximumRows As Integer
Valeur de propriété
Nombre maximal de lignes de données retournées par une source de données pour 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 sont 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 au moment de l’exécution CanPage et ajoutent une DataSourceCapabilities.Page fonctionnalité à l’aide de la méthode si la vue prend en charge la AddSupportedCapabilities(DataSourceCapabilities) pagination. Si le contrôle lié aux données ne parvient pas à ajouter la fonctionnalité et que les propriétés de pagination sont définies sur un DataSourceSelectArguments objet transmis à 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 propriétés et MaximumRows les StartRowIndex propriétés sur l’objet DataSourceSelectArguments passé à la Select(DataSourceSelectArguments, DataSourceViewSelectCallback) méthode.
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.