Compartilhar via


AdditionalProperties

O elemento AdditionalProperties identifica propriedades adicionais para uso em solicitações GetItem, UpdateItem, CreateItem, FindItem ou FindFolder .

<AdditionalProperties>
   <ExtendedFieldURI/>
   <FieldURI/>
   <IndexedFieldURI/>
</AdditionalProperties>

NonEmptyArrayOfPathsToElementType

Atributos e elementos

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

Atributos

Nenhum

Elementos filho

Elemento Descrição
ExtendedFieldURI
Identifica propriedades MAPI estendidas para obter, definir ou criar.
FieldURI
Identifica propriedades referenciadas com frequência pelo URI.
IndexedFieldURI
Identifica propriedades de dicionário frequentemente referenciadas pelo URI.

Elementos pai

Elemento Descrição
FolderShape
Identifica as propriedades da pasta a serem incluídas em uma resposta GetFolder, FindFolder ou SyncFolderHierarchy .

A seguir estão as expressões XPath para esse elemento:

/FindFolder/FolderShape
/GetFolder/FolderShape
/SyncFolderHierarchy/FolderShape
ItemShape
Identifica as propriedades e o conteúdo do item a serem incluídos em uma resposta GetItem, FindItem ou SyncFolderItems .

A seguir estão as expressões XPath para esse elemento:

/GetItem/ItemShape
/FindItem/ItemShape
/SyncFolderItems/ItemShape
AttachmentShape
Identifica propriedades de item estendidas adicionais a serem retornadas em uma resposta a uma solicitação GetItem .

A seguir está a expressão XPath para esse elemento:

/GetAttachment/AttachmentShape

Comentários

Nem todos os elementos filho podem ser usados com solicitações GetItem, UpdateItem, CreateItem, FindItem ou FindFolder . A propriedade deve ser aplicável à pasta ou item acessado. Use propriedades estendidas para acessar outras propriedades. Se a propriedade não existir para um determinado item, nenhum elemento correspondente será emitido no XML resultante.

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.

Esse elemento é opcional.

Exemplo

O exemplo de solicitação a seguir mostra como obter um assunto de item usando o elemento AdditionalProperties .

<?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>
    <GetItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AdditionalProperties>
      </ItemShape>
      <ItemIds>
        <t:ItemId Id="ASkAS="/>
      </ItemIds>
    </GetItem>
  </soap:Body>
</soap:Envelope>

Elemento de informações

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