Compartir a través de


FractionalPageItemView

El elemento FractionalPageItemView describe dónde se inicia la vista paginada y el número máximo de elementos devueltos en una solicitud FindItem .

FindItem

FractionalPageItemView

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

FractionalPageViewType

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
MaxEntriesReturned
Identifica el número máximo de resultados que se devolverán en la respuesta FindItem . Este atributo es opcional. Si no se especifica este atributo, la llamada devolverá todos los elementos disponibles.
Numerador
Representa el numerador del desplazamiento fraccionario desde el inicio del conjunto de resultados. Este atributo es obligatorio. El numerador debe ser igual o menor que el denominador. Este atributo debe representar un valor entero igual o mayor que cero.
Para obtener más información, vea Comentarios más adelante en este tema.
Denominador
Representa el denominador del desplazamiento fraccionario desde el principio del número total de elementos del conjunto de resultados. Este atributo es obligatorio. Este atributo debe representar un valor entero mayor que uno.
Para obtener más información, vea Comentarios más adelante en este tema.

Elementos secundarios

Ninguno.

Elementos principales

Elemento Descripción
FindItem
Define una solicitud para buscar elementos en un buzón.
A continuación se muestra la expresión XPath de este elemento:
/FindItem

Comentarios

El desplazamiento de la vista paginada desde el inicio del conjunto de elementos encontrados se describe mediante una fracción. La fracción, definida por los atributos Numerator y Denominator , describe dónde comienza la página de información. Por ejemplo, si Numerador es igual a cuatro y Denominador es igual a cinco, la página de información devuelta comienza en una entrada ubicada en cuatro quintas partes del camino hacia el conjunto de resultados.

Si la fracción se evalúa como cero, indica el inicio del conjunto de resultados. Si la fracción se evalúa como una, esto indica el final del conjunto de resultados.

Nota:

La fracción representa el punto inicial de la página, no cuántos resultados se devolverán en el conjunto de resultados.

El esquema que describe este elemento se encuentra en el directorio virtual EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.

Ejemplo

En el ejemplo siguiente se muestra una solicitud FindItem . La solicitud devuelve elementos de los resultados de búsqueda que comienzan después del segundo tercio de todos los elementos del 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 ejemplo, si el conjunto de resultados contiene nueve elementos, la vista paginada devolverá hasta 12 elementos, empezando por el elemento que encontró dos tercios del camino hacia el conjunto de resultados. En este caso, la página comienza en el séptimo elemento. La página contendrá los elementos séptimo, octavo y noveno. Si el numerador se establece en cero, la vista de página devolverá todos los elementos del conjunto de resultados siempre que el número sea menor que el atributo MaxEntriesReturned .

Información del elemento

Elemento Ejemplo
Namespace
http://schemas.microsoft.com/exchange/services/2006/messages
Nombre de esquema
Esquema de mensajes
Archivo de validación
Messages.xsd
Puede estar vacío
False

Vea también

Operación FindItem

Buscar elementos