Share via

Hacer referencia a propiedades por espacio de nombres

  • Artículo

En este tema se enumeran los espacios de nombres admitidos por PropertyAccessor, Table, View y sus objetos secundarios, y se describe cómo hacer referencia a propiedades con nombre.

Espacios de nombres usados por los objetos de Outlook

En la siguiente tabla se resumen los espacios de nombres y los objetos de Outlook admitidos por los espacios de nombres. Observe que en las referencias a las propiedades por espacio de nombres se distinguen mayúsculas de minúsculas.

Espacios de nombres Objetos de Outlook admitidos
https://schemas.microsoft.com/mapi/proptag Objetos de elementos de Outlook, AddressEntry, AddressList, Attachment, ExchangeDistributionList, ExchangeUser, Folder, Recipient y Store.
https://schemas.microsoft.com/mapi/id (Igual que arriba)
https://schemas.microsoft.com/mapi/string (Igual que arriba)
https://schemas.microsoft.com/exchange (Igual que arriba)
urn:schemas-microsoft-com:office:office Objetos de elementos de Outlook
urn:schemas-microsoft-com:office:outlook Objetos de elemento de Outlook
DAV: Objetos de elemento de Outlook
urn:schemas:calendar Objetos de elemento de Outlook
urn:schemas:contacts Objetos de elemento de Outlook
urn:schemas:httpmail Objetos de elemento de Outlook
urn:schemas:mailheader Objetos de elementos de Outlook

Espacios de nombres MAPI (Messaging Application Programming Interface)

Muchas de las propiedades admitidas por Outlook son propiedades MAPI. El objeto PropertyAccessor admite tres subespacios de nombres del espacio de nombres MAPI: proptag, id y string. Cada una de las siguientes secciones contiene una descripción del subespacio de nombres, una descripción del formato para hacer referencia a una propiedad en dicho subespacio de nombres y una definición de la sintaxis según se expresa en una forma de Backus-Naur aumentada (ABNF), especificada en[RFC4234].

espacio de nombres proptag

Este espacio de nombres se usa para tener acceso a propiedades del espacio de nombres MAPI usando la etiqueta de propiedad de una propiedad. Solo admite propiedades del rango de propiedades MAPI (es decir, propiedades con un identificador de propiedad inferior a 0 x 8000). A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

https://schemas.microsoft.com/mapi/proptag/0xHHHHHHHH

HHHHHHHH representa el valor hexadecimal de etiqueta de la propiedad, con un identificador de propiedad exclusivo en los 16 bits de orden superior y un tipo de propiedad en los 16 bits de orden inferior. Cada propiedad MAPI debe tener una etiqueta de propiedad, independientemente de si la propiedad es definida por MAPI, Outlook o un proveedor de servicios. El valor hexadecimal debe ir a continuación del prefijo "0x".

Formalmente, las referencias de propiedades en este espacio de nombres se pueden definir en ABNF de la siguiente manera:

  proptag-specifier = "https://schemas.microsoft.com/mapi/proptag/x" property-id property-type 
  property-id = 4HEXDIG 
  property-type = 4HEXDIG

Por ejemplo, a continuación se representa la propiedad MAPI PidTagSubject que Outlook expone en su modelo de objetos como Subject:

https://schemas.microsoft.com/mapi/proptag/0x0037001E

nombre de espacio de id.

Este espacio de nombres se usa para tener acceso a propiedades de un espacio de nombres identificado por el GUID (identificador único global) del espacio de nombres, usando el identificador de la propiedad. A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

https://schemas.microsoft.com/mapi/id/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/HHHHHHHH

{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} representa el GUID del espacio de nombres y HHHHHHHH representa la etiqueta de propiedad.

Formalmente, las referencias de propiedades en este espacio de nombres se pueden definir en ABNF de la siguiente manera:

  id-specifier = "https://schemas.microsoft.com/mapi/id/" property-set "/x" property-long-id 
property-set = "{" 8HEXDIG "-" 4HEXDIG "-" 4HEXDIG "-" 4HEXDIG "-" 12HEXDIG "}" 
property-long-id = 8HEXDIG

Por ejemplo, a continuación se representa la propiedad NoAging de Outlook:

https://schemas.microsoft.com/mapi/id/{00062008-0000-0000-C000-000000000046}/850E000B

espacio de nombres de cadena

Este espacio de nombres se usa para tener acceso a las propiedades con nombre de cadena en un espacio de nombres identificado. A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

https://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/ name

{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} representa el GUID del espacio de nombres y name es el nombre de la propiedad local definido como una cadena.

Formalmente, las referencias de propiedades en este espacio de nombres se pueden definir en ABNF de la siguiente manera:

  string-specifier = "https://schemas.microsoft.com/mapi/string/" property-set "/" property-name 
property-set = "{" 8*HEXDIG "-" 4*HEXDIG "-" 4*HEXDIG "-" 4*HEXDIG "-" 12*HEXDIG "}" 
property-name = 1*CHAR

A continuación se muestra un ejemplo donde se usa este espacio de nombres:

https://schemas.microsoft.com/mapi/string/{00020386-0000-0000-C000-000000000046}/content-class

Se aplican reglas de escape para hacer referencia a propiedades con nombre en el espacio de nombres cadena. Al hacer referencia a una propiedad con nombre que tiene un identificador de cadena (por ejemplo, autor, empresa y puesto), si el nombre de la propiedad contiene un espacio, comillas simples, comillas dobles o caracteres de porcentaje, debe usar el escape del localizador de recursos uniforme (URL) y representar esos caracteres con la cadena de escape correspondiente tal y como se muestra en la siguiente tabla.

Carácter de la referencia de propiedad Cadena de escape
Carácter de espacio %20
Comilla doble %22
Comilla simple %27
Carácter de porcentaje %25

A continuación se muestra un ejemplo de cómo especificar y obtener el valor de una propiedad con nombre, Mom's "Gift", definida en el espacio de nombres de cadena MAPI, mediante el método PropertyAccessor.GetProperty:

  PropertyAccessor.GetProperty("https://schemas.microsoft.com/mapi/string/{00020329-0000-0000-C000-000000000046}/Mom%27s%20%22Gift%22")

Espacio de nombres Exchange

El espacio de nombres Exchange se usa para tener acceso a las propiedades de Exchange con nombre de cadena. A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

https://schemas.microsoft.com/exchange/ name

name es el nombre de la propiedad local definido como una cadena.

A continuación se muestra un ejemplo de una propiedad a la que se hace referencia mediante este espacio de nombres:

https://schemas.microsoft.com/exchange/readreceiptrequested

Espacios de nombres Office

El objeto PropertyAccessor admite dos subespacios de nombres de Office:

Espacio de nombres Office

Este espacio de nombres se usa para tener acceso a las propiedades del objeto DocumentItem. A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

urn:schemas-microsoft-com:office:office# name

name es el nombre de la propiedad local definido como una cadena.

A continuación se muestran algunos ejemplos de referencias a propiedades DocumentItem mediante con el espacio de nombres Office:

  • urn:schemas-microsoft-com:office:office#Subject

  • urn:schemas-microsoft-com:office:office#Template

Espacio de nombres Outlook

Este espacio de nombres se usa para tener acceso a las propiedades de nivel de elemento de Outlook. Al igual que otros espacios de nombres que admiten referencias a las propiedades, use este espacio de nombres para tener acceso a las propiedades de Outlook que no están expuestas de forma explícita en el modelo de objetos. A continuación se ofrece el formato para hacer referencia a una propiedad en este espacio de nombres:

urn:schemas-microsoft-com:office:outlook# name

name es el nombre de la propiedad local definido como una cadena.

A continuación se muestra un ejemplo de referencia a una propiedad de nivel de elemento de Outlook mediante el espacio de nombres Outlook:

urn:schemas-microsoft-com:office:outlook#remotemessagesize

Espacios de nombres Distributed Authoring and Versioning (DAV)

Los espacios de nombres DAV se usan para tener acceso a las propiedades de nivel de elemento de Outlook. Una propiedad en el espacio de nombres DAV se limita usando una referencia al URI del espacio de nombres. El formato es una concatenación del prefijo URI del espacio de nombres y el nombre de la propiedad local expresado en una cadena con el URI del espacio de nombres siendo una URN (Nombre de recursos uniforme) o una URL (localizador de recursos uniforme).

A continuación se muestran los espacios de nombres DAV que admite el objeto PropertyAccessor:

  • DAV:

  • urn:schemas:calendar

  • urn:schemas:contacts

  • urn:schemas:httpmail

  • urn:schemas:mailheader

Éstos son ejemplos de propiedades a las que hacen referencia distintos espacios de nombres:

  • DAV:checkintime

  • urn:schemas:httpmail:subject

  • urn:schemas:mailheader:subject

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.