ContactsView

  • [アーティクル]

ContactsView 要素は、アルファベット順の表示名に基づいて連絡先アイテムの検索を定義します。

FindItem

ContactsView

<ContactsView MaxEntriesReturned="" InitialName="" FinalName="" />

ContactsViewType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
MaxEntriesReturned
FindItem 応答で返される結果の最大数について説明します。
InitialName
応答で返される連絡先リストの名を定義します。 指定した初期名が連絡先リストにない場合は、次の名前が FinalName の後にある場合を除き、カルチャ コンテキストで定義されている次のアルファベット名が返されます。 InitialName 属性を省略すると、応答には連絡先リストの名で始まる連絡先の一覧が含まれます。 この属性は省略可能です。
FinalName
応答で返す連絡先リストの姓を定義します。 FinalName 属性を省略すると、応答には、指定された並べ替え順序で後続のすべての連絡先が含まれます。 指定した最終的な名前が連絡先リストにない場合、カルチャ コンテキストで定義されている次のアルファベット順の名前は除外されます。

たとえば、FinalName="Name" が連絡先リストに含まれていない場合、Name1 または NAME の表示名を持つ連絡先は含まれません。

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

子要素

なし。

親要素

要素 説明
FindItem
メールボックス内のアイテムを検索する要求を定義します。

この要素への XPath 式を次に示します:
/FindItem

注釈

この要素を記述するスキーマは、クライアント アクセス サーバーの役割がインストールされている MicrosoftExchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあります。

例

次の要求の例は、Kelly Rollin の表示名を持つ連絡先から始まる最初の 3 つの連絡先を見つける方法を示しています。

<?xml version="1.0" encoding="utf-8"?>
<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>
    <FindItem Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="contacts:DisplayName"/>
        </t:AdditionalProperties>
      </ItemShape>
      <ContactsView MaxEntriesReturned="3" InitialName="Kelly Rollin" />
      <SortOrder>
        <t:FieldOrder Order="Descending">
          <t:FieldURI FieldURI="contacts:DisplayName"/>
        </t:FieldOrder>
        </SortOrder>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="contacts"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

要素の情報

要素 例
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名
 メッセージ スキーマ
検証ファイル
 Messages.xsd
空に設定可能
 False

関連項目