Share via


DataSourceSelectArguments.RetrieveTotalRowCount Propriedade

Definição

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

Boolean

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.

Aplica-se a

Confira também