ExtendedFieldURI
ExtendedFieldURI 要素 は、拡張 MAPI プロパティを識別します。
<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />
PathToExtendedFieldType
属性と要素
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| DistinguishedPropertySetId |
拡張 MAPI プロパティの既知のプロパティ セットの ID を定義します。 この属性を使用すると、 PropertySetId 属性と PropertyTag 属性を使用できません。 この属性は、PropertyId 属性または PropertyName 属性、 および PropertyType 属性と一緒に 使用する必要 があります。 この トピックの後半にある DistinguishedPropertySetId 属性テーブルには、この属性に使用できる値の一覧が示されています。 この属性は省略可能です。 |
| PropertySetId |
MAPI 拡張プロパティ セットまたは名前空間を識別する GUID によって識別します。 この属性を使用する場合は 、DistinguishedPropertySetId 属性と PropertyTag 属性を使用できません。 この属性は、PropertyId 属性または PropertyName 属性、 および PropertyType 属性と一緒に 使用する必要 があります。 この属性は省略可能です。 |
| PropertyTag |
タグの型部分のないプロパティ タグを識別します。 PropertyTag は、16 進数または短整数として表されます。 プロパティとプロパティの0x8000範囲0xFFFEプロパティのカスタム範囲を表します。 メールボックス データベースが初めてカスタム プロパティを検出すると、そのカスタム プロパティに 0x8000-0xFFFE のカスタム プロパティ範囲内のプロパティ タグが割り当0xFFFE。 特定のカスタム プロパティ タグは、ほとんどの場合、データベース間で異なります。 したがって、プロパティ タグによるカスタム プロパティ要求は、データベースごとに異なるプロパティを返す可能性があります。 PropertyTag 属性 の使用 は、カスタム プロパティでは禁止されています。 代わりに、 PropertySetId 属性と PropertyName 属性または PropertyId 属性を使用 します。 重要: GUID + 名前/ID を使用して、0x8000と0xFFFEのカスタム プロパティにアクセスします。 PropertyTag 属性を 使用する場合、DistinguishedPropertySetId、PropertySetId、PropertyName、PropertyId 属性は使用できません。 この属性は省略可能です。 注: カスタム範囲内のプロパティにプロパティ タグ属性を使用0x8000-0xFFFE。 この場合は、名前付きプロパティを使用する必要があります。 |
| PropertyName |
拡張プロパティを名前で識別します。 このプロパティは、 DistinguishedPropertySetId または PropertySetId と結合する必要があります。 この属性を使用する場合は 、PropertyId 属性と PropertyTag 属性を使用できません。 この属性は省略可能です。 |
| PropertyId |
拡張プロパティをディスパッチ ID で識別します。 ディスパッチ ID は、10 進数または 16 進形式で識別できます。 このプロパティは、 DistinguishedPropertySetId または PropertySetId と結合する必要があります。 この属性を使用すると、 PropertyName 属性と PropertyTag 属性を使用できません。 この属性は省略可能です。 |
| PropertyType |
プロパティ タグのプロパティの種類を表します。 これは、プロパティ タグ内の最も重要な単語に対応します。 このトピックの後の PropertyType 属性テーブルには、この属性に使用できる値が含まれます。 この属性は必須です。 |
DistinguishedPropertySetId 属性
| 値 | 説明 |
|---|---|
| アドレス |
アドレス プロパティ セット ID を名前で識別します。 |
| Appointment |
予定プロパティ セット ID を名前で識別します。 |
| CalendarAssistant |
予定表アシスタント プロパティ セット ID を名前で識別します。 |
| 共通 |
共通プロパティ セット ID を名前で識別します。 |
| InternetHeaders |
インターネット ヘッダー プロパティ セット 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) 整数の配列。 |
| Long |
符号付きまたは符号なし 64 ビット (Int64) の整数。 |
| LongArray |
符号付きまたは符号なし 64 ビット (Int64) 整数の配列。 |
| Null |
プロパティ値なしを示します。 制限や値の取得/設定には使用されません。 これはレポート用にのみ存在します。 |
| オブジェクト |
IUnknown インターフェイスを実装するオブジェクトへのポインター。 制限や値の取得/設定には使用されません。 これはレポート用にのみ存在します。 |
| ObjectArray |
IUnknown インターフェイスを実装するオブジェクトへのポインターの配列。 制限や値の取得/設定には使用されません。 これはレポート用にのみ存在します。 |
| 長い形式の日付 (スラッシュ区切り) |
符号付き 16 ビット整数。 |
| ShortArray |
符号付き 16 ビット整数の配列。 |
| SystemTime |
FILETIME 構造体の形式の 64 ビット整数データと時刻値。 |
| SystemTimeArray |
FILETIME 構造体の形式の 64 ビット整数データと時刻値の配列。 |
| 文字列 |
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 操作内のアイテムの 1 つのプロパティへの更新 を表します。 |
| SetFolderField |
UpdateFolder 操作のフォルダー上の 1 つのプロパティへの更新 を表します。 |
| DeleteItemField |
UpdateItem 操作中にアイテムから特定のプロパティを削除するための削除操作 を表します。 |
| DeleteFolderField |
UpdateFolder 呼び出し中にフォルダーから特定のプロパティを削除するための削除操作を表します。 |
| AppendToItemField |
UpdateItem 操作中にアイテムの 1 つのプロパティに追加する データを識別します。 |
| AppendToFolderField |
UpdateFolder 操作中にフォルダー プロパティに追加する データを指定します。 |
| Exists |
指定されたプロパティがアイテムに存在する場合に true を返す検索式を表します。 |
| FieldURIOrConstant |
別のプロパティと比較するときに使用するプロパティまたは定数値を表します。 |
| IsEqualTo |
プロパティと定数値または別のプロパティを比較し、等しい場合は true と評価される検索式を表します。 |
| IsGreaterThan |
プロパティを定数値または別のプロパティと比較する検索式を表し、最初のプロパティが大きい場合は true を返します。 |
| IsGreaterThanOrEqualTo |
プロパティを定数値または別のプロパティと比較し、最初のプロパティが 2 番目のプロパティ以上の場合は true を返す検索式を表します。 |
| IsLessThan |
プロパティを定数値または別のプロパティと比較し、最初のプロパティが 2 番目のプロパティより小さい場合は true を返す検索式を表します。 |
| IsLessThanOrEqualTo |
プロパティを定数値または別のプロパティと比較し、最初のプロパティが 2 番目のプロパティより小さい場合は true を返す検索式を表します。 |
| IsNotEqualTo |
定数値または別のプロパティとプロパティを比較する検索式を表し、値が同じではない場合は true を返します。 |
| Excludes |
プロパティのビットのマスクを実行します。 |
| Contains |
指定したプロパティに指定された定数文字列値が含まれているかどうかを決定する検索式を表します。 |
| FieldOrder |
結果を並べ替える 1 つのフィールドを表し、並べ替えの方向を示します。 |
注釈
一部の属性は、他の属性と組み合わせて使用できません。 拡張プロパティ属性の無効な組み合わせが含まれている要求は、エラー メッセージを生成します。
この要素を記述するスキーマは、クライアント アクセス サーバーの役割がインストールされている MicrosoftExchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあります。
注意
Microsoft .NET では、Long は 64 ビットの符号付き整数で、MAPI と COM では Long は 32 ビット整数です。 ほとんどの開発者は、Microsoft.NET フレームワークを使用して、Web Services Exchangeアプリケーションを開発します。 したがって、.NET 名前付けは MAPI の名前付けではなく使用されます。
たとえば、MAPI プロパティPR_MESSAGE_FLAGSは、0x0E07 PTLONG 型_です。 .NET では、これは整数と見なされます。 プロパティの拡張プロパティは、PR_MESSAGE_FLAGSとして定義されます <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>。
例
次の要求の例では、2 つのカスタム プロパティを持つアイテムを作成します。 最初のカスタム プロパティの名前は IsMyHouse で、 ブール値は true に設定 されます。 2 番目のカスタム拡張プロパティは 、HousePrices という名前です。 通貨の値の配列が含まれます。
<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>
要素の情報
| 要素 | 例 |
|---|---|
| Namespace |
https://schemas.microsoft.com/exchange/services/2006/types |
| スキーマ名 |
型スキーマ |
| 検証ファイル |
Types.xsd |
| 空に設定可能 |
False |