ExtendedFieldURI

O elemento ExtendedFieldURI identifica uma propriedade MAPI estendida.

<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />

Pathtoextendedfieldtype

Atributos e elementos

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

Atributos

Atributo	Descrição
DistinguishedPropertySetId	Define as IDs conhecidas do conjunto de propriedades para propriedades MAPI estendidas. Se esse atributo for usado, os atributos PropertySetId e PropertyTag não poderão ser usados. Esse atributo deve ser usado com o atributo PropertyId ou PropertyName e o atributo PropertyType . A tabela Atributo DistinguishedPropertySetId posteriormente neste tópico lista os valores possíveis para esse atributo. Esse atributo é opcional.
Propertysetid	Identifica um conjunto de propriedades estendidas mapi ou namespace por meio de seu GUID de identificação. Se esse atributo for usado, o atributo DistinguishedPropertySetId e PropertyTag não poderá ser usado. Esse atributo deve ser usado com o atributo PropertyId ou PropertyName e o atributo PropertyType . Esse atributo é opcional.
Propertytag	Identifica a marca de propriedade sem a parte de tipo da marca. O PropertyTag pode ser representado como um hexadecimal ou um inteiro curto. O intervalo entre 0x8000 e 0xFFFE representa o intervalo personalizado de propriedades. Quando um banco de dados de caixa de correio encontra uma propriedade personalizada pela primeira vez, ele atribui a essa propriedade personalizada uma marca de propriedade dentro do intervalo de propriedades personalizado de 0x8000-0xFFFE. Uma determinada marca de propriedade personalizada provavelmente será diferente entre bancos de dados. Portanto, uma solicitação de propriedade personalizada por marca de propriedade pode retornar propriedades diferentes em bancos de dados diferentes. O uso do atributo PropertyTag é proibido para propriedades personalizadas. Em vez disso, use o atributo PropertySetId e o atributo PropertyName ou PropertyId . IMPORTANTE: acesse qualquer propriedade personalizada entre 0x8000 e 0xFFFE usando o GUID + nome/ID. Se o atributo PropertyTag for usado, os atributos DistinguishedPropertySetId, PropertySetId, PropertyName e PropertyId não poderão ser usados. Esse atributo é opcional. OBSERVAÇÃO: você não pode usar um atributo de marca de propriedade para propriedades dentro do intervalo personalizado 0x8000-0xFFFE. Você deve usar uma propriedade nomeada nesse caso.
PropertyName	Identifica uma propriedade estendida pelo nome. Essa propriedade deve ser associada a DistinguishedPropertySetId ou PropertySetId. Se esse atributo for usado, os atributos PropertyId e PropertyTag não poderão ser usados. Esse atributo é opcional.
PropertyId	Identifica uma propriedade estendida por sua ID de expedição. A ID de expedição pode ser identificada em formatos decimal ou hexadecimal. Essa propriedade deve ser associada a DistinguishedPropertySetId ou PropertySetId. Se esse atributo for usado, os atributos PropertyName e PropertyTag não poderão ser usados. Esse atributo é opcional.
Propertytype	Representa o tipo de propriedade de uma marca de propriedade. Isso corresponde à palavra menos significativa em uma marca de propriedade. A tabela Atributo PropertyType posteriormente neste tópico contém os valores possíveis para esse atributo. Esse atributo é necessário.

Atributo DistinguishedPropertySetId

Valor	Descrição
Endereço	Identifica a ID do conjunto de propriedades de endereço pelo nome.
Compromisso	Identifica a ID do conjunto de propriedades de compromisso pelo nome.
CalendarAssistant	Identifica a ID do conjunto de propriedades do assistente de calendário pelo nome.
Comum	Identifica a ID do conjunto de propriedades comum pelo nome.
InternetHeaders	Identifica a ID do conjunto de cabeçalhos da Internet pelo nome.
Reunião	Identifica a ID do conjunto de propriedades da reunião pelo nome.
Compartilhamento
PublicStrings	Identifica a ID do conjunto de cadeias de caracteres públicas pelo nome.
Tarefa	Identifica a ID do conjunto de propriedades de tarefa pelo nome.
UnifiedMessaging	Identifica a ID do conjunto de mensagens unificada pelo nome.

Atributo PropertyType

Valor	Descrição
ApplicationTime	Um valor duplo que é interpretado como uma data e hora. A parte inteiro é a data e a parte da fração é a hora.
ApplicationTimeArray	Uma matriz de valores duplos que são interpretados como uma data e hora.
Binária	Um valor binário codificado em Base64.
BinaryArray	Uma matriz de valores binários codificados por Base64.
Boolean	Um booliano verdadeiro ou falso.
CLSID	Uma cadeia de caracteres GUID.
CLSIDArray	Uma matriz de cadeias de caracteres GUID.
Moeda	Um inteiro de 64 bits que é interpretado como o número de centavos.
CurrencyArray	Uma matriz de inteiros de 64 bits que são interpretados como o número de centavos.
Duplo	Um valor de ponto flutuante de 64 bits.
DoubleArray	Uma matriz de valores de ponto flutuante de 64 bits.
Error	Valor SCODE; Inteiro sem sinal de 32 bits. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios.
Flutuação	Um valor de ponto flutuante de 32 bits.
FloatArray	Uma matriz de valores de ponto flutuante de 32 bits.
Inteiro	Um inteiro assinado de 32 bits (Int32).
IntegerArray	Uma matriz de inteiros assinados de 32 bits (Int32).
Longo	Um inteiro assinado ou sem sinal de 64 bits (Int64).
LongArray	Uma matriz de inteiros assinados ou não assinados de 64 bits (Int64).
Nulo	Indica nenhum valor de propriedade. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios.
Objeto	Um ponteiro para um objeto que implementa a interface IUnknown. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios.
ObjectArray	Uma matriz de ponteiros para objetos que implementam a interface IUnknown. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios.
Curto	Um inteiro de 16 bits assinado.
ShortArray	Uma matriz de inteiros assinados de 16 bits.
Systemtime	Um valor de tempo e dados inteiros de 64 bits na forma de uma estrutura FILETIME.
SystemTimeArray	Uma matriz de dados inteiros de 64 bits e valores de tempo na forma de uma estrutura FILETIME.
Cadeia de caracteres	Uma cadeia de caracteres Unicode.
StringArray	Uma matriz de cadeias de caracteres Unicode.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
ExtendedProperty	Identifica propriedades estendidas em pastas e itens.
AdditionalProperties	Identifica propriedades adicionais. A seguir estão as expressões XPath para esse elemento: /FindFolder/FolderShape/AdditionalProperties /GetFolder/FolderShape/AdditionalProperties /SyncFolderHierarchy/FolderShape/AdditionalProperties /GetItem/ItemShape/AdditionalProperties /FindItem/ItemShape/AdditionalProperties /SyncFolderItems/ItemShape/AdditionalProperties /GetAttachment/AttachmentShape/AdditionalProperties
SetItemField	Representa uma atualização para uma única propriedade de um item em uma operação UpdateItem.
SetFolderField	Representa uma atualização para uma única propriedade em uma pasta em uma operação UpdateFolder.
DeleteItemField	Representa uma operação de exclusão para excluir uma determinada propriedade de um item durante uma operação UpdateItem.
DeleteFolderField	Representa uma operação de exclusão para excluir uma determinada propriedade de uma pasta durante uma chamada UpdateFolder.
AppendToItemField	Identifica dados a serem acrescentados a uma única propriedade de um item durante uma operação UpdateItem.
AppendToFolderField	Especifica dados a serem acrescentados a uma propriedade de pasta durante uma operação UpdateFolder.
Existe	Representa uma expressão de pesquisa que retorna true se a propriedade fornecida existir em um item.
FieldURIOrConstant	Representa uma propriedade ou um valor constante a ser usado ao comparar com outra propriedade.
IsEqualTo	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e avalia como true se elas forem iguais.
IsGreaterThan	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for maior.
IsGreaterThanOrEqualTo	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for maior ou igual à segunda.
IsLessThan	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for menor que a segunda.
IsLessThanOrEqualTo	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for menor que a segunda.
IsNotEqualTo	Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se os valores não forem os mesmos.
Exclui	Executa uma máscara bit a bit das propriedades.
Contém	Representa uma expressão de pesquisa que determina se uma determinada propriedade contém o valor de cadeia de caracteres constante fornecido.
FieldOrder	Representa um único campo pelo qual classificar os resultados e indica a direção para o tipo.

Comentários

Alguns atributos não podem ser usados em combinação com outros atributos. Qualquer solicitação que venha com uma combinação inválida de atributos de propriedade estendida gerará uma mensagem de erro.

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.

Observação

No Microsoft .NET, um Long é um inteiro assinado de 64 bits, enquanto em MAPI e COM, um Long é um inteiro de 32 bits. A maioria dos desenvolvedores usará o Microsoft.NET Framework para desenvolver aplicativos cliente do Exchange Web Services. Portanto, a nomenclatura do .NET é usada em vez da nomenclatura MAPI.

Por exemplo, a propriedade MAPI PR_MESSAGE_FLAGS, 0x0E07, é um tipo PT_LONG. No .NET, isso é considerado um inteiro. Uma propriedade estendida para PR_MESSAGE_FLAGS é definida como <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

Exemplo

O exemplo a seguir de uma solicitação cria um item que tem duas propriedades personalizadas. A primeira propriedade personalizada é chamada IsMyHouse com um valor booliano definido como true. A segunda propriedade estendida personalizada se chama HousePrices. Ele contém uma matriz de valores Conversor de Moedas.

<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>
    <CreateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
    MessageDisposition="SaveOnly">
      <SavedItemFolderId>
        <t:DistinguishedFolderId Id="inbox"/>
      </SavedItemFolderId>
      <Items>
        <t:Item>
          <t:ItemClass>IPM.Note</t:ItemClass>
          <t:Subject>Create an extended property</t:Subject>
          <t:Body BodyType="Text">Added info to extended props</t:Body>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="IsMyHouse" 
                                PropertyType="Boolean"/>
            <t:Value>true</t:Value>
          </t:ExtendedProperty>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="HousePrices" 
                                PropertyType="CurrencyArray"/>
            <t:Values>
              <t:Value>30000000</t:Value>
              <t:Value>40000000</t:Value>
              <t:Value>50000000</t:Value>
            </t:Values>
          </t:ExtendedProperty>
        </t:Item>
      </Items>
    </CreateItem>
  </soap:Body>
</soap:Envelope>

Elemento de informações

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

Confira também

• FieldURI
• IndexedFieldURI
• Elementos XML do EWS no Exchange