Contact Class

連絡先を表します。

構文


var contact = new Windows.ApplicationModel.Contacts.Contact();

属性

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

メンバー

Contactクラス には次の種類のメンバーがあります。

コンストラクター

Contactクラス にはこれらのコンストラクターがあります。

コンストラクター説明
Contact Creates a new instance of the Contact class.

 

メソッド

The Contact クラス からメソッドを継承します。Object クラス (C#/VB/C++).

プロパティ

Contactクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Addresses

読み取り専用Gets the contact addresses for a contact.

ConnectedServiceAccounts

読み取り専用Gets the connected service accounts for a contact.

DataSuppliers

読み取り専用Gets the data suppliers for a contact. The maximum string length for each data supplier is 50 characters.

DisplayName

読み取り専用Gets the display name for a contact. You can only access this property from a UI thread.

Emails

読み取り専用Gets the email addresses for a contact.

Fields

読み取り専用Fields may be altered or unavailable for releases after Windows 8.1. Instead, use Phones, Emails, Addresses, or ConnectedServiceAccounts. Sets the fields that contain information about a contact.

FirstName

読み取り/書き込みGets and sets the first name for a contact. The maximum string length for the first name is 64 characters.

HonorificNamePrefix

読み取り/書き込みGets and sets the honorific prefix for the name for a contact. The maximum string length for the honorific prefix is 32 characters.

HonorificNameSuffix

読み取り/書き込みGets and sets the honorific suffix for the name for a contact. The maximum string length for the honorific suffix is 32 characters.

Id

読み取り/書き込みGets and sets the identifier for a contact. The maximum string length for the identifier is 256 characters.

ImportantDates

読み取り専用Gets the important dates for a contact.

JobInfo

読み取り専用Gets the job info items for a contact.

LastName

読み取り/書き込みGets and sets the last name for a contact. The maximum string length for the last name is 64 characters.

MiddleName

読み取り/書き込みGets and sets the middle name for a contact. The maximum string length for the middle name is 64 characters.

Name

読み取り/書き込みName may be altered or unavailable for releases after Windows 8.1. Instead, use FirstName. Sets and gets the name of the contact.

Notes

読み取り/書き込みGets and sets notes for a contact. The maximum string length for notes is 4096 characters.

Phones

読み取り専用Gets info about the phones for a contact.

ProviderProperties

読み取り専用Gets the property set object for the contact.

SignificantOthers

読み取り専用Gets the significant others for a contact.

Thumbnail

読み取り/書き込みGets or sets a thumbnail image that represents this contact.

Websites

読み取り専用Gets the Web sites for a contact.

YomiDisplayName

読み取り専用Gets the Yomi (phonetic Japanese equivalent) display name for a contact.

YomiFamilyName

読み取り/書き込みGets the Yomi (phonetic Japanese equivalent) family name for a contact. The maximum string length for the Yomi family name is 120 characters.

YomiGivenName

読み取り/書き込みGets the Yomi (phonetic Japanese equivalent) given name for a contact. The maximum string length for the Yomi given name is 120 characters.

 

解説

アプリケーションに連絡先情報をどのように格納しても、Contact オブジェクトにその情報の入力を可能にする必要があります。このようにすることにより、ユーザーが連絡先を選択できる他のアプリケーションは、アプリケーションを使用して、提供する連絡先情報を処理できるようになります。

このコードは、アプリケーションがアプリケーション固有の連絡先オブジェクトを受け取る方法、および Contact オブジェクトの作成のためにそれを使用する方法を示しています。最初に、連絡先情報を含むオブジェクトの例を次に示します。


var sampleContacts = [
    {
        firstName: "Kim",
        lastName: "Abercrombie",
        image: "KimAbercrombie.jpg",
        personalEmail: "kim@contoso.com",
        homePhone: "921 555-0187",
        address: {
            full: "123 Main St, Redmond WA, 23456",
            street: "123 Main St",
            city: "Redmond",
            state: "WA",
            zipCode: "23456"
        },
        id: "49b0652e-8f39-48c5-853b-e5e94e6b8a11"
    }
];


この関数は、複数のフィールドをサポートする連絡先を作成します:


function createContactForBasket(sampleContact) {

    // Transfer contact data to a Contact object
    var contact = new Windows.ApplicationModel.Contacts.Contact();
    contact.firstName = sampleContact.firstName;
    contact.lastName = sampleContact.lastName;
    contact.id = sampleContact.id;

    // Add the personal email address to the Contact object’s emails vector
    var personalEmail = new Windows.ApplicationModel.Contacts.ContactEmail();
    personalEmail.address = sampleContact.personalEmail;
    personalEmail.kind = Windows.ApplicationModel.Contacts.ContactEmailKind.personal;
    contact.emails.append(personalEmail);

    // Adds the home phone number to the Contact object’s phones vector
    var homePhone = new Windows.ApplicationModel.Contacts.ContactPhone();
    homePhone.number = sampleContact.homePhone;
    homePhone.kind = Windows.ApplicationModel.Contacts.ContactPhoneKind.home;
    contact.phones.append(homePhone);

    // Adds the address to the Contact object’s addresses vector
    var homeAddress = new Windows.ApplicationModel.Contacts.ContactAddress();
    homeAddress.streetAddress = sampleContact.address.street;
    homeAddress.locality = sampleContact.address.city;
    homeAddress.region = sampleContact.address.state;
    homeAddress.postalCode = sampleContact.address.zipCode;
    homeAddress.kind = Windows.ApplicationModel.Contacts.ContactAddressKind.home;
    contact.addresses.append(homeAddress);

    // Sets the thumbnail for the contact from path
    Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(sampleContact.image).then(
          function (imageFile) {
                 var streamReference = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(imageFile);
                 contact.thumbnail = randomAccessStreamReference;
          });

    return contact;
}


要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

名前空間

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

メタデータ

Windows.winmd

 

 

表示:
© 2014 Microsoft