Partilhar via


DataSourceSelectArguments.MaximumRows Propriedade

Definição

Obtém ou define um valor que representa o número máximo de linhas de dados que um controle de fonte de dados retorna para uma operação de recuperação de dados.

public:
 property int MaximumRows { int get(); void set(int value); };
public int MaximumRows { get; set; }
member this.MaximumRows : int with get, set
Public Property MaximumRows As Integer

Valor da propriedade

Int32

O número máximo de linhas de dados que uma fonte de dados retorna para uma operação de recuperação de dados. O valor padrão é 0, o que indica que todas as linhas de dados possíveis são retornadas.

Comentários

A MaximumRows Propriedade dá suporte a cenários de paginação. Os controles vinculados a dados verificam a propriedade de uma exibição da fonte de dados CanPage em tempo de execução e adicionam um DataSourceCapabilities.Page recurso usando o AddSupportedCapabilities(DataSourceCapabilities) método se a exibição der suporte à paginação. Se o controle vinculado a dados falhar ao adicionar o recurso e as propriedades de paginação forem definidas em um DataSourceSelectArguments objeto passado para a exibição da fonte de dados durante uma operação de recuperação de dados, uma InvalidOperationException exceção poderá ser gerada.

O controle associado a dados pode solicitar um subconjunto de dados de um controle da fonte de dados para paginação, definindo as StartRowIndex MaximumRows Propriedades e no DataSourceSelectArguments objeto passado para o Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 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