Compartilhar via


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="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="http://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
http://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