ContactCollection Class

Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

Represents a collection of Contact objects.

Feature:  Microsoft.Live.Services
Namespace:  Microsoft.Live.Services

The JavaScript Library for Windows Live Messenger Connect is built by using the Microsoft Ajax Library. Microsoft Ajax exposes a type system that enables you to add object-oriented capabilities to your JavaScript code. To learn more about creating, instantiating, and deriving from classes, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Microsoft.Live.Services.ContactCollection = function();


The ContactCollection inherits from the DataCollection class that provides methods to refresh, save, and search through collections.

The following example demonstrates how to work with a ContactCollection.

            dataContext.loadAll(Microsoft.Live.DataType.contacts, function (contactsLoadedEvent) {
                if (contactsLoadedEvent.get_resultCode() !== Microsoft.Live.AsyncResultCode.success) return;
                var contactsCollection = contactsLoadedEvent.get_data();
                var itemArray = contactsCollection.items;
                var length = itemArray.length; // same as contactsCollection.get_length()
                alert("Items found = " + length);

Windows Live Messenger Connect

Supported in: 4.1

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.6, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 4.0, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0