ExtendedFieldURI

El elemento ExtendedFieldURI identifica una propiedad MAPI extendida.

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

PathToExtendedFieldType

Atributos y elementos

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

Atributos

Atributo	Descripción
DistinguishedPropertySetId	Define los identificadores del conjunto de propiedades conocidos para las propiedades MAPI extendidas. Si se usa este atributo, no se pueden usar los atributos PropertySetId y PropertyTag . Este atributo debe usarse con el atributo PropertyId o PropertyName y el atributo PropertyType . La tabla DistinguishedPropertySetId Attribute más adelante en este tema enumera los valores posibles para este atributo. Este atributo es opcional.
PropertySetId	Identifica un conjunto de propiedades extendidas MAPI o un espacio de nombres mediante su GUID de identificación. Si se usa este atributo, no se pueden usar los atributos DistinguishedPropertySetId y PropertyTag . Este atributo debe usarse con el atributo PropertyId o PropertyName y el atributo PropertyType . Este atributo es opcional.
PropertyTag	Identifica la etiqueta de propiedad sin la parte de tipo de la etiqueta. PropertyTag se puede representar como un entero hexadecimal o corto. El intervalo entre 0x8000 y 0xFFFE representa el intervalo personalizado de propiedades. Cuando una base de datos de buzón de correo encuentra una propiedad personalizada por primera vez, asigna a esa propiedad personalizada una etiqueta de propiedad dentro del intervalo de propiedades personalizado de 0x8000-0xFFFE. Es probable que una etiqueta de propiedad personalizada determinada difiera entre bases de datos. Por lo tanto, una solicitud de propiedad personalizada por etiqueta de propiedad puede devolver propiedades diferentes en bases de datos diferentes. El uso del atributo PropertyTag está prohibido para las propiedades personalizadas. En su lugar, use el atributo PropertySetId y el atributo PropertyName o PropertyId . IMPORTANTE: Acceda a cualquier propiedad personalizada entre 0x8000 y 0xFFFE mediante el GUID + nombre/identificador. Si se usa el atributo PropertyTag , no se pueden usar los atributos DistinguishedPropertySetId, PropertySetId, PropertyName y PropertyId . Este atributo es opcional. NOTA: No se puede usar un atributo de etiqueta de propiedad para las propiedades dentro del intervalo personalizado 0x8000-0xFFFE. En este caso, debe usar una propiedad con nombre.
PropertyName	Identifica una propiedad extendida por su nombre. Esta propiedad debe combinarse con DistinguishedPropertySetId o PropertySetId. Si se usa este atributo, no se pueden usar los atributos PropertyId y PropertyTag . Este atributo es opcional.
PropertyId	Identifica una propiedad extendida por su identificador de distribución. El identificador de distribución se puede identificar en formatos decimales o hexadecimales. Esta propiedad debe combinarse con DistinguishedPropertySetId o PropertySetId. Si se usa este atributo, no se pueden usar los atributos PropertyName y PropertyTag . Este atributo es opcional.
PropertyType	Representa el tipo de propiedad de una etiqueta de propiedad. Esto corresponde a la palabra menos significativa de una etiqueta de propiedad. La tabla Atributo PropertyType más adelante en este tema contiene los valores posibles para este atributo. Este atributo es obligatorio.

Atributo DistinguishedPropertySetId

Valor	Descripción
Address	Identifica el identificador del conjunto de propiedades de dirección por nombre.
Cita	Identifica el identificador del conjunto de propiedades de cita por nombre.
CalendarAssistant	Identifica el identificador del conjunto de propiedades del asistente de calendario por nombre.
Común	Identifica el identificador del conjunto de propiedades común por nombre.
InternetHeaders	Identifica el identificador del conjunto de propiedades de encabezados de Internet por nombre.
Reunión	Identifica el identificador del conjunto de propiedades de reunión por nombre.
Compartir
PublicStrings	Identifica el identificador del conjunto de propiedades de cadenas públicas por nombre.
Tarea	Identifica el identificador del conjunto de propiedades de tarea por nombre.
UnifiedMessaging	Identifica el identificador del conjunto de propiedades de mensajería unificada por nombre.

Atributo PropertyType

Valor	Descripción
ApplicationTime	Valor doble que se interpreta como una fecha y hora. La parte entera es la fecha y la parte de fracción es la hora.
ApplicationTimeArray	Matriz de valores dobles que se interpretan como una fecha y hora.
Binario	Valor binario codificado en Base64.
BinaryArray	Matriz de valores binarios codificados en Base64.
Boolean	Un valor booleano true o false.
CLSID	Cadena GUID.
CLSIDArray	Matriz de cadenas GUID.
Divisa	Entero de 64 bits que se interpreta como el número de céntimos.
CurrencyArray	Matriz de enteros de 64 bits que se interpretan como el número de céntimos.
Doble	Valor de punto flotante de 64 bits.
DoubleArray	Matriz de valores de punto flotante de 64 bits.
Error	Valor de SCODE; Entero de 32 bits sin signo. No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Float	Valor de punto flotante de 32 bits.
FloatArray	Matriz de valores de punto flotante de 32 bits.
Entero	Entero de 32 bits (Int32) con signo.
IntegerArray	Matriz de enteros de 32 bits (Int32) con signo.
Long	Entero de 64 bits (Int64) firmado o sin signo.
LongArray	Matriz de enteros de 64 bits (Int64) con signo o sin signo.
Null	Indica que no hay ningún valor de propiedad. No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Objeto	Puntero a un objeto que implementa la interfaz IUnknown. No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
ObjectArray	Matriz de punteros a objetos que implementan la interfaz IUnknown. No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Corta	Entero de 16 bits con signo.
ShortArray	Matriz de enteros de 16 bits con signo.
SystemTime	Un valor de tiempo y datos enteros de 64 bits en forma de estructura FILETIME.
SystemTimeArray	Matriz de datos enteros de 64 bits y valores de tiempo en forma de estructura FILETIME.
Cadena	Cadena Unicode.
StringArray	Matriz de cadenas Unicode.

Elementos secundarios

Ninguno.

Elementos principales

Elemento	Descripción
ExtendedProperty	Identifica las propiedades extendidas en carpetas y elementos.
AdditionalProperties	Identifica propiedades adicionales. Las siguientes son las expresiones XPath de este elemento: /FindFolder/FolderShape/AdditionalProperties /GetFolder/FolderShape/AdditionalProperties /SyncFolderHierarchy/FolderShape/AdditionalProperties /GetItem/ItemShape/AdditionalProperties /FindItem/ItemShape/AdditionalProperties /SyncFolderItems/ItemShape/AdditionalProperties /GetAttachment/AttachmentShape/AdditionalProperties
SetItemField	Representa una actualización de una sola propiedad de un elemento en una operación UpdateItem.
SetFolderField	Representa una actualización de una sola propiedad en una carpeta de una operación UpdateFolder.
DeleteItemField	Representa una operación de eliminación para eliminar una propiedad determinada de un elemento durante una operación UpdateItem.
DeleteFolderField	Representa una operación de eliminación para eliminar una propiedad determinada de una carpeta durante una llamada a UpdateFolder.
AppendToItemField	Identifica los datos que se van a anexar a una sola propiedad de un elemento durante una operación UpdateItem.
AppendToFolderField	Especifica los datos que se anexan a una propiedad de carpeta durante una operación UpdateFolder.
Exists	Representa una expresión de búsqueda que devuelve true si la propiedad proporcionada existe en un elemento.
FieldURIOrConstant	Representa una propiedad o un valor constante que se va a usar al comparar con otra propiedad.
IsEqualTo	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y se evalúa como true si son iguales.
IsGreaterThan	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es mayor.
IsGreaterThanOrEqualTo	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es mayor o igual que la segunda.
IsLessThan	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es menor que la segunda.
IsLessThanOrEqualTo	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es menor que la segunda.
IsNotEqualTo	Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si los valores no son iguales.
Excluye	Realiza una máscara bit a bit de las propiedades.
Contains	Representa una expresión de búsqueda que determina si una propiedad determinada contiene el valor de cadena constante proporcionado.
FieldOrder	Representa un único campo por el que ordenar los resultados e indica la dirección de la ordenación.

Comentarios

Algunos atributos no se pueden usar en combinación con otros atributos. Cualquier solicitud que se incluya con una combinación no válida de atributos de propiedad extendida generará un mensaje de error.

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.

Nota:

En Microsoft .NET, long es un entero de 64 bits con signo, mientras que en MAPI y COM, long es un entero de 32 bits. La mayoría de los desarrolladores usarán Microsoft.NET Framework para desarrollar aplicaciones cliente de Exchange Web Services. Por lo tanto, se usa la nomenclatura de .NET en lugar de la nomenclatura MAPI.

Por ejemplo, la propiedad PR_MESSAGE_FLAGS MAPI, 0x0E07, es un tipo PT_LONG. En .NET, se considera un entero. Una propiedad extendida para PR_MESSAGE_FLAGS se define como <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

Ejemplo

En el ejemplo siguiente de una solicitud se crea un elemento que tiene dos propiedades personalizadas. La primera propiedad personalizada se denomina IsMyHouse con un valor booleano establecido en true. La segunda propiedad extendida personalizada se denomina HousePrices. Contiene una matriz de valores currency.

<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>

Información del elemento

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

Vea también

• FieldURI
• IndexedFieldURI
• Elementos XML de EWS en Exchange