ContactsViewContactsView

ContactsView要素は、アルファベットの表示名に基づいて連絡先アイテムの検索を定義します。The ContactsView element defines a search for contact items based on alphabetical display names.

FindItemFindItem

ContactsViewContactsView

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

ContactsViewTypeContactsViewType

属性と要素Attributes and elements

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
MaxEntriesReturnedMaxEntriesReturned
FindItem応答で返される結果の最大数を表します。Describes the maximum number of results to return in the FindItem response.
InitialNameInitialName
応答で返される連絡先リストの最初の名前を定義します。Defines the first name in the contacts list to return in the response. 指定したイニシャル名が連絡先リストにない場合は、次の名前がファイナライズ名の後にある場合を除いて、文化的コンテキストによって定義された次のアルファベット名が返されます。If the specified initial name is not in the contacts list, the next alphabetical name as defined by the cultural context will be returned, except if the next name comes after FinalName. Initialname属性が省略されている場合、応答には、連絡先リストの最初の名前から始まる連絡先の一覧が含まれます。If the InitialName attribute is omitted, the response will contain a list of contacts that starts with the first name in the contact list. この属性は省略可能です。This attribute is optional.
FinalNameFinalName
応答で返される連絡先リストの姓を定義します。Defines the last name in the contacts list to return in the response. Finalname属性が省略されている場合、応答には、指定された並べ替え順序に後続のすべての連絡先が含まれます。If the FinalName attribute is omitted, the response will contain all subsequent contacts in the specified sort order. 指定した最終名が連絡先リストにない場合は、文化的コンテキストによって定義された次のアルファベット名が除外されます。If the specified final name is not in the contacts list, the next alphabetical name as defined by the cultural context will be excluded.

たとえば、FinalName = "Name" (名前が連絡先リストに含まれていない) の場合、Name1 または名前の表示名を持つ連絡先は含まれません。For example, if FinalName="Name", but Name is not in the contacts list, contacts that have display names of Name1 or NAME will not be included.

この属性は省略可能です。This attribute is optional.

子要素Child elements

なし。None.

親要素Parent elements

要素Element 説明Description
FindItemFindItem
メールボックス内のアイテムを検索するための要求を定義します。Defines a request to find items in a mailbox.

この要素の XPath 式を次に示します。The following is the XPath expression to this element:
/FindItem

注釈Remarks

この要素を記述するスキーマは、クライアントアクセスサーバーの役割がインストールされている Microsoft Exchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあります。The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

Example

次の要求例は、友野司郎の表示名を持つ連絡先から始まる最初の3つの連絡先を検索する方法を示しています。The following example of a request demonstrates how to find the first three contacts starting with the contact that has the display name of Kelly Rollin.

<?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>

要素の情報Element information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名Schema Name
メッセージスキーマMessages schema
検証ファイルValidation File
メッセージ .xsdMessages.xsd
空に設定可能Can be Empty
正しくないFalse

関連項目See also