次の方法で共有


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 属性を 使用する場合、DistinguishedPropertySetIdPropertySetIdPropertyNamePropertyId 属性は使用できません。

この属性は省略可能です。

: カスタム範囲内のプロパティにプロパティ タグ属性を使用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

関連項目