ObjectDataSourceView.EnablePaging Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o controlo de fonte de dados suporta a paginação através do 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 de Propriedade
true, se o controlo de fonte de dados suportar a paginação através dos dados que recupera; caso contrário, false.
Observações
A paginação pelo ObjectDataSourceView controlo é gerida definindo os EnablePaging, StartRowIndexParameterName, MaximumRowsParameterName, e SelectCountMethod propriedades do ObjectDataSourceView e definindo um Select método no objeto de negócio com os parâmetros adequados. Quando a EnablePaging propriedade é definida para true, a SelectParameters coleção inclui dois parâmetros adicionais para a primeira linha solicitada e para o número de linhas solicitadas. Estes dois parâmetros são nomeados conforme definido pelas StartRowIndexParameterName propriedades e MaximumRowsParameterName . O Select método deve devolver o número pedido de linhas começando no índice especificado. Como os dados podem não se dividir de forma uniforme 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 que são devolvidas.
A CanRetrieveTotalRowCount propriedade é verificada durante uma chamada ao ExecuteSelect método para garantir que o controlo de fonte de dados suporta todas as capacidades solicitadas, definindo as várias DataSourceSelectArguments propriedades.
Quando a paginação está ativada no controlo associado ao limite de dados, o controlo ligado aos 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 controlo databound chama o método antes de renderizar os controlos do pager. Por exemplo, se um GridView controlo tiver a paginação ativada com um tamanho de página 5, e o SelectCountMethod método devolver 20, apenas 4 páginas são exibidas no pager.
O valor da EnablePaging propriedade é armazenado no estado de visualização.