ContactsView

  • Artículo

El elemento ContactsView define una búsqueda de elementos de contacto en función de los nombres para mostrar alfabéticos.

FindItem

ContactsView

<ContactsView MaxEntriesReturned="" InitialName="" FinalName="" />

ContactsViewType

Atributos y elementos

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

Atributos

Atributo Descripción
MaxEntriesReturned
Describe el número máximo de resultados que se devolverán en la respuesta FindItem .
InitialName
Define el nombre de la lista de contactos que se va a devolver en la respuesta. Si el nombre inicial especificado no está en la lista de contactos, se devolverá el siguiente nombre alfabético definido por el contexto cultural, excepto si el nombre siguiente viene después de FinalName. Si se omite el atributo InitialName , la respuesta contendrá una lista de contactos que comienza con el nombre en la lista de contactos. Este atributo es opcional.
FinalName
Define el apellido de la lista de contactos que se va a devolver en la respuesta. Si se omite el atributo FinalName , la respuesta contendrá todos los contactos posteriores en el criterio de ordenación especificado. Si el nombre final especificado no está en la lista de contactos, se excluirá el siguiente nombre alfabético definido por el contexto cultural.

Por ejemplo, si FinalName="Name", pero Name no está en la lista de contactos, no se incluirán los contactos que tengan nombres para mostrar de Name1 o NAME.

Este atributo es opcional.

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 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 de una solicitud se muestra cómo encontrar los tres primeros contactos a partir del contacto que tiene el nombre para mostrar de Kelly Rollin.

<?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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="contacts:DisplayName"/>
        </t:AdditionalProperties>
      </ItemShape>
      <ContactsView MaxEntriesReturned="3" InitialName="Kelly Rollin" />
      <SortOrder>
        <t:FieldOrder Order="Descending">
          <t:FieldURI FieldURI="contacts:DisplayName"/>
        </t:FieldOrder>
        </SortOrder>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="contacts"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

Información del elemento

Elemento Ejemplo
Namespace
 https://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