Udostępnij za pośrednictwem


DataSourceSelectArguments.MaximumRows Właściwość

Definicja

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, set
Public Property MaximumRows As Integer

Wartość właściwości

Int32

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.

Dotyczy

Zobacz też