DataSourceSelectArguments.RetrieveTotalRowCount 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 um controle de fonte de dados deve recuperar uma contagem de todas as linhas de dados durante uma operação de recuperação de dados.
public:
property bool RetrieveTotalRowCount { bool get(); void set(bool value); };
public bool RetrieveTotalRowCount { get; set; }
member this.RetrieveTotalRowCount : bool with get, set
Public Property RetrieveTotalRowCount As Boolean
Valor da propriedade
true
Se o controle da fonte de dados deve recuperar uma contagem total de linhas de dados; caso contrário, false
.
Comentários
A RetrieveTotalRowCount Propriedade dá suporte a cenários de paginação. Defina essa propriedade como true
para solicitar uma contagem total de linhas do controle da fonte de dados durante a operação de recuperação de dados. Verifique a DataSourceView.CanRetrieveTotalRowCount propriedade para determinar se uma exibição da fonte de dados dá suporte à recuperação de uma contagem total de linhas. Se a fonte de dados oferecer suporte a ela, a TotalRowCount propriedade será definida pelo controle da fonte de dados durante o curso de uma operação de recuperação de dados e a contagem total de linhas de dados será retornada na TotalRowCount propriedade, muito como um valor é retornado em um parâmetro de saída de um método.
Importante
Se qualquer uma das DataSourceSelectArguments Propriedades for definida, mas o controle da fonte de dados associada no momento não oferecer suporte à funcionalidade solicitada, uma InvalidOperationException exceção será lançada quando o DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) método for chamado.