DataSourceSelectArguments.MaximumRows 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 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, setPublic Property MaximumRows As IntegerValor da propriedade
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 associados a dados verificam a propriedade de uma exibição de CanPage fonte de dados em tempo de execução e adicionam uma DataSourceCapabilities.Page funcionalidade usando o AddSupportedCapabilities(DataSourceCapabilities) método se a exibição der suporte à paginação. Se o controle associado a dados falhar ao adicionar a funcionalidade 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 exceção InvalidOperationException poderá ser gerada.
O controle associado a dados pode solicitar um subconjunto de dados de um controle de fonte de dados para paginação definindo as propriedades e MaximumRows as StartRowIndex propriedades no DataSourceSelectArguments objeto passadas para o Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método.
Importante
Se alguma das DataSourceSelectArguments propriedades estiver definida, mas o controle de fonte de dados associado no momento não oferecer suporte à funcionalidade solicitada, uma exceção InvalidOperationException será gerada quando o DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) método for chamado.
