ExtendedFieldURIExtendedFieldURI

ExtendedFieldURI元素标识一个扩展的 MAPI 属性。The ExtendedFieldURI element identifies an extended MAPI property.

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

PathToExtendedFieldTypePathToExtendedFieldType

属性和元素Attributes and elements

下面各部分介绍了属性、子元素和父元素。The following sections describe attributes, child elements, and parent elements.

AttributesAttributes

属性Attribute 说明Description
DistinguishedPropertySetIdDistinguishedPropertySetId
定义扩展 MAPI 属性的已知属性集 Id。Defines the well-known property set IDs for extended MAPI properties.

如果使用此属性,则不能使用PropertySetIdPropertyTag属性。If this attribute is used, the PropertySetId and PropertyTag attributes cannot be used. 此属性必须与PropertyIdPropertyName属性一起使用,并且必须与recordtype属性一起使用。This attribute must be used with either the PropertyId or PropertyName attribute, and the PropertyType attribute.

本主题后面的DistinguishedPropertySetId属性表列出了此属性的可能值。The DistinguishedPropertySetId Attribute table later in this topic lists the possible values for this attribute.

此特性是可选的。This attribute is optional.
PropertySetIdPropertySetId
通过识别 GUID 标识 MAPI 扩展属性集或命名空间。Identifies a MAPI extended property set or namespace by its identifying GUID.

如果使用此属性,则不能使用DistinguishedPropertySetIdPropertyTag属性。If this attribute is used, the DistinguishedPropertySetId and PropertyTag attribute cannot be used. 此属性必须与PropertyIdPropertyName属性一起使用,并且必须与recordtype属性一起使用。This attribute must be used with either the PropertyId or PropertyName attribute, and the PropertyType attribute.

此特性是可选的。This attribute is optional.
PropertyTagPropertyTag
标识不包含类型部分标记的属性标记。Identifies the property tag without the type part of the tag. PropertyTag可以表示为十六进制或短整型。The PropertyTag can be represented as either a hexadecimal or a short integer.

0x8000 和0xFFFE 之间的范围表示属性的自定义范围。The range between 0x8000 and 0xFFFE represents the custom range of properties. 当邮箱数据库首次遇到自定义属性时,它会将该自定义属性分配给0xFFFE 的自定义属性范围内的属性标记。When a mailbox database encounters a custom property for the first time, it assigns that custom property a property tag within the custom property range of 0x8000-0xFFFE. 给定的自定义属性标记很可能在不同的数据库中。A given custom property tag will most likely differ across databases. 因此,按属性标记的自定义属性请求可能会在不同的数据库上返回不同的属性。Therefore, a custom property request by property tag can return different properties on different databases. 对自定义属性禁止使用PropertyTag属性。The use of the PropertyTag attribute is prohibited for custom properties. 而是使用PropertySetId属性和PropertyNamePropertyId属性。Instead, use the PropertySetId attribute and the PropertyName or PropertyId attribute.

重要说明:使用 GUID + 名称/ID 访问0X8000 和0xFFFE 之间的任何自定义属性。IMPORTANT: Access any custom property between 0x8000 and 0xFFFE by using the GUID + name/ID. 如果使用了PropertyTag属性,则不能使用DistinguishedPropertySetIdPropertySetIdPropertyNamePropertyId属性。If the PropertyTag attribute is used, the DistinguishedPropertySetId, PropertySetId, PropertyName, and PropertyId attributes cannot be used.

此特性是可选的。This attribute is optional.

注意:不能对自定义范围0x8000 中的属性使用属性 Tag 属性0xFFFE。NOTE: You cannot use a property tag attribute for properties within the custom range 0x8000-0xFFFE. 在这种情况下,您必须使用命名属性。You must use a named property in this case.
PropertyNamePropertyName
按其名称标识扩展属性。Identifies an extended property by its name. 此属性必须与DistinguishedPropertySetIdPropertySetId结合使用。This property must be coupled with either DistinguishedPropertySetId or PropertySetId.

如果使用此属性,则不能使用PropertyIdPropertyTag属性。If this attribute is used, the PropertyId and PropertyTag attributes cannot be used.

此特性是可选的。This attribute is optional.
PropertyIdPropertyId
按其调度 ID 标识扩展属性。Identifies an extended property by its dispatch ID. 可以通过十进制或十六进制格式标识调度 ID。The dispatch ID can be identified in either decimal or hexadecimal formats. 此属性必须与DistinguishedPropertySetIdPropertySetId结合使用。This property must be coupled with either DistinguishedPropertySetId or PropertySetId.

如果使用此属性,则不能使用PropertyNamePropertyTag属性。If this attribute is used, the PropertyName and PropertyTag attributes cannot be used.

此特性是可选的。This attribute is optional.
RecordtypePropertyType
表示属性标记的属性类型。Represents the property type of a property tag. 这对应于属性标记中的最不重要的单词。This corresponds to the least significant word in a property tag.

本主题后面的 Recordtype 属性表包含此属性的可能值。The PropertyType Attribute table later in this topic contains the possible values for this attribute.

此特性是必需的。This attribute is required.

DistinguishedPropertySetId 属性DistinguishedPropertySetId Attribute

Value 说明Description
地址Address
按名称标识 address 属性集 ID。Identifies the address property set ID by name.
AppointmentAppointment
按名称标识约会属性集 ID。Identifies the appointment property set ID by name.
CalendarAssistantCalendarAssistant
按名称标识日历助理属性集 ID。Identifies the calendar assistant property set ID by name.
常见Common
按名称标识通用属性集 ID。Identifies the common property set ID by name.
InternetHeadersInternetHeaders
按名称标识 Internet 标头属性集 ID。Identifies the Internet headers property set ID by name.
要求Meeting
按名称标识会议属性集 ID。Identifies the meeting property set ID by name.
共享Sharing

PublicStringsPublicStrings
按名称标识公共字符串属性集 ID。Identifies the public strings property set ID by name.
任务Task
按名称标识任务属性集 ID。Identifies the task property set ID by name.
UnifiedMessagingUnifiedMessaging
按名称标识统一消息属性集 ID。Identifies the unified messaging property set ID by name.

Recordtype 属性PropertyType Attribute

Value 说明Description
ApplicationTimeApplicationTime
一个被解释为日期和时间的双精度值。A double value that is interpreted as a date and time. 整数部分是日期,小数部分是时间。The integer part is the date and the fraction part is the time.
ApplicationTimeArrayApplicationTimeArray
将被解释为日期和时间的双精度型值组成的数组。An array of double values that are interpreted as a date and time.
BinaryBinary
Base64 编码的二进制值。A Base64-encoded binary value.
BinaryArrayBinaryArray
一个由 Base64 编码的二进制值组成的数组。An array of Base64-encoded binary values.
BooleanBoolean
布尔值truefalseA Boolean true or false.
CLSIDCLSID
一个 GUID 字符串。A GUID string.
CLSIDArrayCLSIDArray
GUID 字符串的数组。An array of GUID strings.
货币Currency
一个64位整数,它被解释为美分数。A 64-bit integer that is interpreted as the number of cents.
CurrencyArrayCurrencyArray
一个由64位整数组成的数组,该数组被解释为美分数。An array of 64-bit integers that are interpreted as the number of cents.
双精度Double
64位浮点值。A 64-bit floating-point value.
DoubleArrayDoubleArray
64位浮点值的数组。An array of 64-bit floating-point values.
错误Error
SCODE 值;32位无符号整数。SCODE value; 32-bit unsigned integer.
不用于限制或获取/设置值。Not used for restrictions or for getting/setting values. 这仅适用于报告。This exists only for reporting.
浮点Float
32位浮点值。A 32-bit floating-point value.
FloatArrayFloatArray
32位浮点值的数组。An array of 32-bit floating-point values.
IntegerInteger
一个已签名的32位(Int32)整数。A signed 32-bit (Int32) integer.
IntegerArrayIntegerArray
一个由已签名的32位(Int32)整数组成的数组。An array of signed 32-bit (Int32) integers.
长型Long
一个已签名或未签名的64位(Int64)整数。A signed or unsigned 64-bit (Int64) integer.
LongArrayLongArray
已签名或未签名的64位(Int64)整数的数组。An array of signed or unsigned 64-bit (Int64) integers.
NULLNull
指示无属性值。Indicates no property value.
不用于限制或获取/设置值。Not used for restrictions or for getting/setting values. 这仅适用于报告。This exists only for reporting.
对象Object
指向实现 IUnknown 接口的对象的指针。A pointer to an object that implements the IUnknown interface.
不用于限制或获取/设置值。Not used for restrictions or for getting/setting values. 这仅适用于报告。This exists only for reporting.
ObjectArrayObjectArray
指向实现 IUnknown 接口的对象的指针数组。An array of pointers to objects that implement the IUnknown interface.
不用于限制或获取/设置值。Not used for restrictions or for getting/setting values. 这仅适用于报告。This exists only for reporting.
Short
一个有符号的16位整数。A signed 16-bit integer.
ShortArrayShortArray
一个由带符号的16位整数组成的数组。An array of signed 16-bit integers.
SystemTimeSystemTime
一个以 FILETIME 结构形式表示的64位整数数据和时间值。A 64-bit integer data and time value in the form of a FILETIME structure.
SystemTimeArraySystemTimeArray
以 FILETIME 结构形式的64位整数数据和时间值的数组。An array of 64-bit integer data and time values in the form of a FILETIME structure.
StringString
一个 Unicode 字符串。A Unicode string.
StringArrayStringArray
Unicode 字符串的数组。An array of Unicode strings.

子元素Child elements

无。None.

父元素Parent elements

元素Element 说明Description
ExtendedPropertyExtendedProperty
标识文件夹和项的扩展属性。Identifies extended properties on folders and items.
AdditionalPropertiesAdditionalProperties
标识其他属性。Identifies additional properties.

下面是此元素的 XPath 表达式:The following are the XPath expressions to this element:

/FindFolder/FolderShape/AdditionalProperties
/GetFolder/FolderShape/AdditionalProperties
/SyncFolderHierarchy/FolderShape/AdditionalProperties
/GetItem/ItemShape/AdditionalProperties
/FindItem/ItemShape/AdditionalProperties
/SyncFolderItems/ItemShape/AdditionalProperties
/GetAttachment/AttachmentShape/AdditionalProperties
SetItemFieldSetItemField
表示对UpdateItem 操作中项的单个属性的更新。Represents an update to a single property of an item in an UpdateItem operation.
SetFolderFieldSetFolderField
表示对UpdateFolder Operation中的文件夹上的单个属性的更新。Represents an update to a single property on a folder in an UpdateFolder operation.
DeleteItemFieldDeleteItemField
表示在UpdateItem 操作过程中从项中删除给定属性的删除操作。Represents a delete operation for deleting a given property from an item during an UpdateItem operation.
DeleteFolderFieldDeleteFolderField
表示在 UpdateFolder 调用过程中从文件夹中删除给定属性的删除操作。Represents a delete operation for deleting a given property from a folder during an UpdateFolder call.
AppendToItemFieldAppendToItemField
标识在UpdateItem 操作过程中追加到项的单个属性的数据。Identifies data to append to a single property of an item during an UpdateItem operation.
AppendToFolderFieldAppendToFolderField
指定要在UpdateFolder Operation期间追加到文件夹属性数据。Specifies data to append to a folder property during an UpdateFolder operation.
ExistsExists
表示在项上存在提供的属性时返回true的搜索表达式。Represents a search expression that returns true if the supplied property exists on an item.
FieldURIOrConstantFieldURIOrConstant
表示与其他属性进行比较时要使用的属性或常数值。Represents either a property or a constant value to be used when comparing with another property.
IsEqualToIsEqualTo
表示搜索表达式,该表达式将属性与常数值或其他属性进行比较,如果它们相等,则计算结果为trueRepresents a search expression that compares a property with either a constant value or another property and evaluates to true if they are equal.
IsGreaterThanIsGreaterThan
表示用于将属性与常数值或其他属性进行比较的搜索表达式,如果第一个属性较大,则返回trueRepresents a search expression that compares a property with either a constant value or another property and returns true if the first property is greater.
IsGreaterThanOrEqualToIsGreaterThanOrEqualTo
表示一个搜索表达式,该表达式将属性与一个常数值或另一个属性进行比较,如果第一个属性大于或等于第二个属性,则返回 trueRepresents a search expression that compares a property with either a constant value or another property and returns true if the first property is greater than or equal to the second.
IsLessThanIsLessThan
表示一个搜索表达式,该表达式将属性与一个常量值或另一个属性进行比较,如果第一个属性小于第二个属性,则返回trueRepresents a search expression that compares a property with either a constant value or another property and returns true if the first property is less than the second.
IsLessThanOrEqualToIsLessThanOrEqualTo
表示一个搜索表达式,该表达式将属性与一个常量值或另一个属性进行比较,如果第一个属性小于第二个属性,则返回trueRepresents a search expression that compares a property with either a constant value or another property and returns true if the first property is less than the second.
IsNotEqualToIsNotEqualTo
表示用于将属性与常量值或其他属性进行比较的搜索表达式,如果值不相同,则返回 trueRepresents a search expression that compares a property with either a constant value or another property and returns true if the values are not the same.
不包括Excludes
执行这些属性的位掩码。Performs a bitwise mask of the properties.
ContainsContains
表示一个搜索表达式,该表达式确定给定属性是否包含提供的常量字符串值。Represents a search expression that determines whether a given property contains the supplied constant string value.
FieldOrderFieldOrder
代表对结果进行排序所依据的单个字段,并指示排序的方向。Represents a single field by which to sort results and indicates the direction for the sort.

备注Remarks

有些属性不能与其他属性结合使用。Some attributes cannot be used in combination with other attributes. 任何传入的扩展属性属性组合无效的请求都将生成错误消息。Any request that comes in with an invalid combination of extended property attributes will generate an error message.

描述此元素的架构位于正在运行 MicrosoftExchange Server 2007 的计算机(已安装客户端访问服务器角色)的 EWS 虚拟目录中。The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

备注

在 Microsoft .NET 中,Long 是一个64位带符号整数,而在 MAPI 和 COM 中,Long 为32位整数。In Microsoft .NET, a Long is a 64-bit signed integer, while in MAPI and COM, a Long is a 32-bit integer. 大多数开发人员将使用 Microsoft.NET 框架开发 Exchange Web 服务客户端应用程序。Most developers will use the Microsoft.NET Framework to develop Exchange Web Services client applications. 因此,使用的是 .NET 命名,而不是 MAPI 命名。Therefore, the .NET naming is used instead of the MAPI naming.

例如,PR_MESSAGE_FLAGS MAPI 属性0x0E07 是 _ LONG 类型。For example, the PR_MESSAGE_FLAGS MAPI property, 0x0E07, is a PT_LONG type. 在 .NET 中,这被视为一个整数。In .NET, this is considered an integer. PR_MESSAGE_FLAGS 的扩展属性定义为 <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>An extended property for PR_MESSAGE_FLAGS is defined as <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

示例Example

下面的请求示例将创建一个具有两个自定义属性的项。The following example of a request creates an item that has two custom properties. 第一个自定义属性的名称为IsMyHouse ,其布尔值设置为trueThe first custom property is named IsMyHouse with a Boolean value set to true. 第二个自定义扩展属性名为HousePricesThe second custom extended property is named HousePrices. 它包含一个货币值数组。It contains an array of Currency values.

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

元素信息Element information

命名空间Namespace
https://schemas.microsoft.com/exchange/services/2006/types
架构名称Schema Name
类型架构Types schema
验证文件Validation File
Types.xsdTypes.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also