FractionalPageItemView

O elemento FractionalPageItemView descreve onde o modo de exibição de página é iniciado e o número máximo de itens retornados em uma solicitação FindItem .

FindItem

FractionalPageItemView

<FractionalPageItemView MaxEntriesReturned="" Numerator="" Denominator=""/>

Fractionalpageviewtype

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
MaxEntriesReturned	Identifica o número máximo de resultados a serem retornados na resposta FindItem . Esse atributo é opcional. Se esse atributo não for especificado, a chamada retornará todos os itens disponíveis.
Numerador	Representa o numerador do deslocamento fracionário desde o início do conjunto de resultados. Esse atributo é necessário. O numerador deve ser igual ou menor que o denominador. Esse atributo deve representar um valor integral igual ou maior que zero. Para obter mais informações, confira Comentários mais adiante neste tópico.
Denominador	Representa o denominador do deslocamento fracionário desde o início do número total de itens no conjunto de resultados. Esse atributo é necessário. Esse atributo deve representar um valor integral maior que um. Para obter mais informações, confira Comentários mais adiante neste tópico.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
FindItem	Define uma solicitação para encontrar itens em uma caixa de correio. A seguir está a expressão XPath para esse elemento: /FindItem

Comentários

O deslocamento de exibição de página do início do conjunto de itens encontrados é descrito por uma fração. A fração, que é definida pelos atributos Numerador e Denominador , descreve onde a página de informações começa. Por exemplo, se Numerador for igual a quatro e Denominador for igual a cinco, a página de informações retornadas começará em uma entrada localizada em quatro quintos do caminho para o conjunto de resultados.

Se a fração for avaliada como zero, isso indicará o início do conjunto de resultados. Se a fração for avaliada como uma, isso indicará o fim do conjunto de resultados.

Observação

A fração representa o ponto de início da página, e não quantos resultados no conjunto de resultados serão retornados.

O esquema que descreve este elemento está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem instalada a função de servidor de Acesso para Cliente.

Exemplo

O exemplo a seguir mostra uma solicitação FindItem . A solicitação retorna itens dos resultados da pesquisa que começam após o segundo terço de todos os itens no conjunto de resultados.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AdditionalProperties>
      </ItemShape>
      <FractionalPageItemView MaxEntriesReturned="12" Numerator="2" Denominator="3"/>
      <GroupBy Order="Descending">
        <t:FieldURI FieldURI="item:Importance"/>
        <t:AggregateOn Aggregate="Maximum">
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AggregateOn>
      </GroupBy>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

Por exemplo, se o conjunto de resultados contiver nove itens, o modo de exibição de página retornará até 12 itens, começando pelo item encontrado dois terços do caminho para o conjunto de resultados. Nesse caso, a página começa no sétimo item. A página conterá o sétimo, oitavo e nono itens. Se o numerador estiver definido como zero, o modo de exibição de página retornará todos os itens no conjunto de resultados, desde que o número seja menor que o atributo MaxEntriesReturned .

Elemento de informações

Elemento	Exemplo
Namespace	http://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema	Esquema de mensagens
Arquivo de validação	Messages.xsd
Pode ser vazio	False

Confira também

Operação FindItem

Localizando itens