ObjectDataSourceView.EnablePaging 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ść wskazującą, czy kontrolka źródła danych obsługuje stronicowanie za pośrednictwem zestawu pobieranych danych.
public:
property bool EnablePaging { bool get(); void set(bool value); };public bool EnablePaging { get; set; }member this.EnablePaging : bool with get, setPublic Property EnablePaging As BooleanWartość właściwości
true, jeśli kontrolka źródła danych obsługuje stronicowanie za pośrednictwem pobieranych danych; w przeciwnym razie , false.
Uwagi
Stronicowanie za pomocą kontrolki ObjectDataSourceView jest obsługiwane przez ustawienie EnablePagingwłaściwości ObjectDataSourceView , , StartRowIndexParameterNameMaximumRowsParameterNamei SelectCountMethod oraz zdefiniowanie Select metody w obiekcie biznesowym przy użyciu odpowiednich parametrów. Gdy właściwość jest ustawiona EnablePaging na truewartość , SelectParameters kolekcja zawiera dwa dodatkowe parametry dla pierwszego żądanego wiersza i liczbę żądanych wierszy. Te dwa parametry są nazwane zgodnie z definicją StartRowIndexParameterName właściwości i MaximumRowsParameterName . Metoda Select powinna zwrócić żądaną liczbę wierszy rozpoczynających się od określonego indeksu. Ponieważ dane mogą nie być równomiernie podzielone według rozmiaru strony, ostatnia strona może zawierać mniej wierszy. W związku z tym liczba żądanych wierszy jest w rzeczywistości maksymalną liczbą zwracanych wierszy.
Właściwość CanRetrieveTotalRowCount jest sprawdzana podczas wywołania ExecuteSelect metody, aby upewnić się, że kontrolka źródła danych obsługuje wszystkie możliwości żądane przez ustawienie różnych DataSourceSelectArguments właściwości.
Gdy stronicowanie jest włączone w skojarzonej kontrolce powiązanej z danymi, kontrolka powiązana z danymi wywołuje metodę Select z indeksem początkowym i liczbą wymaganych wierszy. Ponadto jeśli SelectCountMethod właściwość jest ustawiona, kontrolka powiązana z danymi wywołuje metodę przed renderowaniem kontrolek pager. Jeśli na przykład kontrolka GridView ma włączoną stronicowanie z rozmiarem strony 5, a SelectCountMethod metoda zwraca 20, w stronicowaniu są wyświetlane tylko 4 strony.
Wartość EnablePaging właściwości jest przechowywana w stanie widoku.