ExtendedFieldURI

项目
03/29/2023

ExtendedFieldURI 元素标识扩展的 MAPI 属性。

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

PathToExtendedFieldType

属性和元素

下面各部分介绍了属性、子元素和父元素。

Attributes

属性	说明
DistinguishedPropertySetId	定义扩展 MAPI 属性的已知属性集 ID。如果使用此属性，则无法使用 PropertySetId 和 PropertyTag 属性。此属性必须与 PropertyId 或 PropertyName 属性以及 PropertyType 属性一起使用。本主题后面的 DistinguishedPropertySetId 属性表列出了此属性的可能值。此特性是可选的。
PropertySetId	通过标识 GUID 来标识 MAPI 扩展属性集或命名空间。如果使用此属性，则不能使用 DistinguishedPropertySetId 和 PropertyTag 属性。此属性必须与 PropertyId 或 PropertyName 属性以及 PropertyType 属性一起使用。此特性是可选的。
PropertyTag	标识没有标记的类型部分的属性标记。 PropertyTag 可以表示为十六进制整数或短整数。 0x8000 和 0xFFFE 之间的范围表示自定义属性范围。当邮箱数据库首次遇到自定义属性时，它会为该自定义属性分配0x8000-0xFFFE自定义属性范围内的属性标记。给定的自定义属性标记很可能因数据库而异。因此，按属性标记的自定义属性请求可以返回不同数据库上的不同属性。禁止对自定义属性使用 PropertyTag 属性。请改用 PropertySetId 属性和 PropertyName 或 PropertyId 属性。重要说明：使用 GUID + 名称/ID 访问 0x8000 和 0xFFFE 之间的任何自定义属性。如果使用 PropertyTag 属性，则无法使用 DistinguishedPropertySetId、 PropertySetId、 PropertyName 和 PropertyId 属性。此特性是可选的。注意：不能对自定义范围内的属性使用属性标记属性0x8000-0xFFFE。在这种情况下，必须使用命名属性。
PropertyName	按扩展属性的名称标识扩展属性。此属性必须与 DistinguishedPropertySetId 或 PropertySetId 结合使用。如果使用此属性，则不能使用 PropertyId 和 PropertyTag 属性。此特性是可选的。
PropertyId	按扩展属性的调度 ID 标识扩展属性。调度 ID 可以采用十进制或十六进制格式进行标识。此属性必须与 DistinguishedPropertySetId 或 PropertySetId 结合使用。如果使用此属性，则无法使用 PropertyName 和 PropertyTag 属性。此特性是可选的。
PropertyType	表示属性标记的属性类型。这对应于属性标记中最不重要的单词。本主题后面的 PropertyType Attribute 表包含此属性的可能值。此特性是必需的。

DistinguishedPropertySetId 属性

值	说明
地址	按名称标识地址属性集 ID。
Appointment	按名称标识约会属性集 ID。
CalendarAssistant	按名称标识日历助手属性集 ID。
常见	按名称标识公共属性集 ID。
InternetHeaders	按名称标识 Internet 标头属性集 ID。
会议	按名称标识会议属性集 ID。
共享
PublicStrings	按名称标识公共字符串属性集 ID。
任务	按名称标识任务属性集 ID。
UnifiedMessaging	按名称标识统一消息属性集 ID。

PropertyType 属性

值	说明
ApplicationTime	解释为日期和时间的双精度值。整数部分是日期，分数部分是时间。
ApplicationTimeArray	被解释为日期和时间的双精度值的数组。
Binary	Base64 编码的二进制值。
BinaryArray	Base64 编码的二进制值的数组。
Boolean	布尔值 true 或 false。
CLSID	GUID 字符串。
CLSIDArray	GUID 字符串的数组。
货币	解释为美分数的 64 位整数。
CurrencyArray	一个由 64 位整数构成的数组，这些整数被解释为美分数。
双精度	64 位浮点值。
DoubleArray	包含 64 位浮点值的数组。
Error	SCODE 值;32 位无符号整数。不用于限制或获取/设置值。这仅适用于报告。
浮点	32 位浮点值。
FloatArray	32 位浮点值的数组。
整数	有符号 32 位 (Int32) 整数。
IntegerArray	有符号的 32 位 (Int32) 整数的数组。
长型	有符号或无符号 64 位 (int64) 整数。
LongArray	有符号或无符号 64 位 (int64) 整数的数组。
NULL	指示无属性值。不用于限制或获取/设置值。这仅适用于报告。
Object	指向实现 IUnknown 接口的对象的指针。不用于限制或获取/设置值。这仅适用于报告。
ObjectArray	指向实现 IUnknown 接口的对象的指针数组。不用于限制或获取/设置值。这仅适用于报告。
短	有符号 16 位整数。
ShortArray	带符号 16 位整数的数组。
SystemTime	FILETIME 结构形式的 64 位整数数据和时间值。
SystemTimeArray	由 FILETIME 结构形式的 64 位整数数据和时间值组成的数组。
String	Unicode 字符串。
StringArray	Unicode 字符串的数组。

子元素

无。

父元素

元素	说明
ExtendedProperty	标识文件夹和项上的扩展属性。
AdditionalProperties	标识其他属性。下面是此元素的 XPath 表达式： `/FindFolder/FolderShape/AdditionalProperties` `/GetFolder/FolderShape/AdditionalProperties` `/SyncFolderHierarchy/FolderShape/AdditionalProperties` `/GetItem/ItemShape/AdditionalProperties` `/FindItem/ItemShape/AdditionalProperties` `/SyncFolderItems/ItemShape/AdditionalProperties` `/GetAttachment/AttachmentShape/AdditionalProperties`
SetItemField	表示对 UpdateItem 操作中项的单个属性的更新。
SetFolderField	表示对UpdateFolder Operation中的文件夹上的单个属性的更新。
DeleteItemField	表示在 UpdateItem 操作期间从项中删除给定属性的删除操作。
DeleteFolderField	表示在 UpdateFolder 调用期间从文件夹中删除给定属性的删除操作。
AppendToItemField	标识在 UpdateItem 操作期间要追加到项的单个属性的数据。
AppendToFolderField	指定要在UpdateFolder Operation期间追加到文件夹属性数据。
Exists	表示一个搜索表达式，如果提供的属性存在于项上，则返回 true 。
FieldURIOrConstant	表示与另一个属性进行比较时要使用的属性或常量值。
IsEqualTo	表示一个搜索表达式，该表达式将某个属性与常量值或另一个属性进行比较，如果它们相等，则计算结果为 true 。
IsGreaterThan	表示一个搜索表达式，该表达式将属性与常量值或另一个属性进行比较，如果第一个属性较大，则返回 true 。
IsGreaterThanOrEqualTo	表示一个搜索表达式，该表达式将某个属性与常量值或另一个属性进行比较，如果第一个属性大于或等于第二个属性，则返回 true 。
IsLessThan	表示一个搜索表达式，该表达式将某个属性与常量值或另一个属性进行比较，如果第一个属性小于第二个属性，则返回 true 。
IsLessThanOrEqualTo	表示一个搜索表达式，该表达式将某个属性与常量值或另一个属性进行比较，如果第一个属性小于第二个属性，则返回 true 。
IsNotEqualTo	表示一个搜索表达式，该表达式将属性与常量值或其他属性进行比较，如果值不相同，则返回 true 。
不包括	执行这些属性的位掩码。
Contains	表示一个搜索表达式，该表达式确定给定属性是否包含提供的常量字符串值。
FieldOrder	表示对结果进行排序的单个字段，并指示排序方向。

备注

某些属性不能与其他属性结合使用。附带扩展属性属性组合无效的任何请求都将生成错误消息。

描述此元素的架构位于正在运行 MicrosoftExchange Server 2007 的计算机（已安装客户端访问服务器角色）的 EWS 虚拟目录中。

注意

在 Microsoft .NET 中，Long 是 64 位有符号整数，而在 MAPI 和 COM 中，Long 是 32 位整数。大多数开发人员将使用 Microsoft.NET 框架来开发 Exchange Web Services 客户端应用程序。因此，使用 .NET 命名而不是 MAPI 命名。

例如，PR_MESSAGE_FLAGS MAPI 属性0x0E07是一种PT_LONG类型。在 .NET 中，这被视为整数。 PR_MESSAGE_FLAGS的扩展属性定义为 <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>。

示例

以下示例请求创建一个具有两个自定义属性的项。第一个自定义属性名为 IsMyHouse ，其布尔值设置为 true。第二个自定义扩展属性名为 HousePrices。它包含 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="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>

元素信息

元素	示例
命名空间	https://schemas.microsoft.com/exchange/services/2006/types
架构名称	类型架构
验证文件	Types.xsd
可以为空	False