ObjectDataSourceView.EnablePaging Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se il controllo origine dati supporta il paging tramite il set di dati recuperati.
public:
property bool EnablePaging { bool get(); void set(bool value); };
public bool EnablePaging { get; set; }
member this.EnablePaging : bool with get, set
Public Property EnablePaging As Boolean
Valore della proprietà
true, se il controllo origine dati supporta il paging dei dati recuperati; in caso contrario, false.
Commenti
Il paging da parte del ObjectDataSourceView controllo viene gestito impostando le EnablePagingproprietà , MaximumRowsParameterNameStartRowIndexParameterName, e SelectCountMethod di ObjectDataSourceView e definendo un Select metodo nell'oggetto business con i parametri appropriati. Quando la proprietà è impostata su true, l'insieme EnablePagingSelectParameters include due parametri aggiuntivi per la prima riga richiesta e il numero di righe richieste. Questi due parametri sono denominati come definiti dalle StartRowIndexParameterName proprietà e MaximumRowsParameterName . Il Select metodo deve restituire il numero richiesto di righe a partire dall'indice specificato. Poiché i dati potrebbero non essere divisi uniformemente per le dimensioni della pagina, l'ultima pagina potrebbe contenere meno righe. Pertanto, il numero di righe richieste è in realtà il numero massimo di righe restituite.
La CanRetrieveTotalRowCount proprietà viene controllata durante una chiamata al ExecuteSelect metodo per assicurarsi che il controllo origine dati supporti tutte le funzionalità richieste impostando le varie DataSourceSelectArguments proprietà.
Quando il paging è abilitato nel controllo associato a dati, il controllo associato a dati chiama il Select metodo con l'indice iniziale e il numero di righe necessarie. Inoltre, se la SelectCountMethod proprietà è impostata, il controllo associato a dati chiama il metodo prima di eseguire il rendering dei controlli cercapersone. Ad esempio, se il paging di un GridView controllo è abilitato con dimensioni di pagina pari a 5 e il SelectCountMethod metodo restituisce 20, nel cercapersone vengono visualizzate solo 4 pagine.
Il valore della EnablePaging proprietà viene archiviato nello stato di visualizzazione.