DataSourceSelectArguments.MaximumRows 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.
Obtém ou define um valor que representa o número máximo de linhas de dados que um controlo de fonte de dados devolve 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 de Propriedade
O número máximo de linhas de dados que uma fonte de dados devolve 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 devolvidas.
Observações
A MaximumRows propriedade suporta cenários de paginação. Controlos de dados limitados verificam a propriedade da CanPage vista da fonte de dados em tempo de execução e adicionam uma DataSourceCapabilities.Page capacidade usando o AddSupportedCapabilities(DataSourceCapabilities) método se a vista suportar paginação. Se o controlo data-bound falhar em adicionar a capacidade, e as propriedades de paginação forem definidas num DataSourceSelectArguments objeto passado para a vista da fonte de dados durante uma operação de recuperação de dados, pode ser lançada uma InvalidOperationException exceção.
O controlo data-bound pode solicitar um subconjunto de dados a um controlo de fonte de dados para paginação, definindo as StartRowIndex propriedades e MaximumRows no DataSourceSelectArguments objeto passado para o Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método.
Importante
Se alguma das DataSourceSelectArguments propriedades estiver definida, mas o controlo de fonte de dados atualmente atribuído não suportar a capacidade solicitada, é lançada uma InvalidOperationException exceção quando o DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) método é chamado.