DataSourceSelectArguments.MaximumRows Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość reprezentującą maksymalną liczbę wierszy danych zwracanych przez kontrolkę źródła danych dla operacji pobierania danych.
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 IntegerWartość właściwości
Maksymalna liczba wierszy danych zwracanych przez źródło danych dla operacji pobierania danych. Wartość domyślna to 0, co oznacza, że zwracane są wszystkie możliwe wiersze danych.
Uwagi
MaximumRowsWłaściwość obsługuje scenariusze stronicowania. Formanty powiązane z danymi sprawdzają właściwość widoku źródła danych CanPage w czasie wykonywania i dodają DataSourceCapabilities.Page funkcję przy użyciu metody, AddSupportedCapabilities(DataSourceCapabilities) Jeśli widok obsługuje stronicowanie. Jeśli formant powiązany z danymi nie może dodać możliwości, a właściwości stronicowania są ustawiane na DataSourceSelectArguments obiekcie przekazanym do widoku źródła danych podczas operacji pobierania danych, InvalidOperationException może zostać zgłoszony wyjątek.
Formant powiązany z danymi może zażądać podzestawu danych z kontroli źródła danych na potrzeby stronicowania przez ustawienie StartRowIndex MaximumRows właściwości i DataSourceSelectArguments obiektu przekazaną do Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metody.
Ważne
Jeśli dowolna z DataSourceSelectArguments właściwości jest ustawiona, ale aktualnie powiązane kontrolka źródła danych nie obsługuje żądanych możliwości, InvalidOperationException wyjątek jest zgłaszany, gdy DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) wywoływana jest metoda.