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 indicante se il controllo origine dati supporta il paging dell'insieme 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à , StartRowIndexParameterName, MaximumRowsParameterNamee SelectCountMethod di ObjectDataSourceView e definendo un Select
metodo nell'oggetto business con i parametri appropriati. Quando la EnablePaging proprietà è impostata su true
, l'insieme SelectParameters 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 in modo uniforme per le dimensioni della pagina, l'ultima pagina potrebbe contenere meno righe. Di conseguenza, 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 ai dati, il controllo associato ai dati chiama il metodo con l'indice iniziale e il Select
numero di righe necessarie. Inoltre, se la SelectCountMethod proprietà è impostata, il controllo associato ai dati chiama il metodo prima di eseguire il rendering dei controlli del pager. Ad esempio, se un GridView controllo dispone di paging abilitato con dimensioni di pagina pari a 5 e il metodo restituisce 20, vengono SelectCountMethod visualizzate solo 4 pagine nel pager.
Il valore della proprietà viene archiviato nello stato di EnablePaging visualizzazione.