ObjectDataSourceView.EnablePaging Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o controle de fonte de dados é compatível com paginação no conjunto de dados que recupera.
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 BooleanValor da propriedade
true, se o controle da fonte de dados der suporte à paginação por meio dos dados recuperados; caso contrário, false.
Comentários
A paginação pelo ObjectDataSourceView controle é tratada definindo as EnablePagingStartRowIndexParameterNameSelectCountMethod MaximumRowsParameterNamepropriedades e propriedades ObjectDataSourceView do e definindo um Select método no objeto de negócios com os parâmetros adequados. Quando a EnablePaging propriedade é definida como true, a SelectParameters coleção inclui dois parâmetros adicionais para a primeira linha solicitada e o número de linhas solicitadas. Esses dois parâmetros são nomeados conforme definido pela StartRowIndexParameterName propriedade e MaximumRowsParameterName pelas propriedades. O Select método deve retornar o número solicitado de linhas começando no índice especificado. Como os dados podem não ser divididos uniformemente pelo tamanho da página, a última página pode conter menos linhas. Assim, o número de linhas solicitadas é, na verdade, o número máximo de linhas retornadas.
A CanRetrieveTotalRowCount propriedade é verificada durante uma chamada ao método para ExecuteSelect garantir que o controle da fonte de dados dê suporte a todos os recursos solicitados definindo as várias DataSourceSelectArguments propriedades.
Quando a paginação é habilitada no controle associado a dados, o controle associado a dados chama o Select método com o índice inicial e o número de linhas necessárias. Além disso, se a SelectCountMethod propriedade estiver definida, o controle associado a dados chamará o método antes de renderizar os controles do pager. Por exemplo, se um GridView controle tiver paginação habilitada com um tamanho de página de 5 e o SelectCountMethod método retornar 20, apenas 4 páginas serão exibidas no pager.
O valor da EnablePaging propriedade é armazenado no estado de exibição.