ExtendedFieldURI
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="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>
元素信息
| 元素 | 示例 |
|---|---|
| 命名空间 |
http://schemas.microsoft.com/exchange/services/2006/types |
| 架构名称 |
类型架构 |
| 验证文件 |
Types.xsd |
| 可以为空 |
False |