ContactCategory 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.

A LiveItem instance that provides programmatic access to the category information for a Windows Live contact.

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.ContactCategory = function();


The ContactCategory class represents a container that is used to group user contacts. A ContactCategory can contact zero or more contacts. Contacts can belong to more than one category. To retrieve contacts defined for the category, use the contacts property.

The following example demonstrates how to get a DataContext instance from the App class dataContext property, create a ContactCategoryCollection instance, and list the properties for each ContactCategory object in the collection.

var sb, out, br = "</br>";
function appLoaded(applicationLoadCompletedEventArgs) {
    var dataContext = wl.App.get_dataContext();
    out = document.getElementById("Output");
    sb = "Loading ContactCategories." + br;
    dataContext.waitForsignIn(function(signInCompletedEventArgs) {
        if (signInCompletedEventArgs.get_resultCode() !== wl.AsyncResultCode.success) {
            alert("Sign in failed.");
        else {
            dataContext.loadAll(Microsoft.Live.DataType.contactCategories, contactCategoriesLoaded);
function contactCategoriesLoaded(dataLoadCompletedEventArgs) {
    if (dataLoadCompletedEventArgs.get_resultCode() !== Microsoft.Live.AsyncResultCode.success) {
        alert("ContactCategories failed to load");
    contactCategoriesCollection = dataLoadCompletedEventArgs.get_data();
    for (var i = 0; i < contactCategoriesCollection.get_length(); i++) {
        var contactCategory = contactCategoriesCollection.get_item(i);
        sb += contactCategory.get_title() + ", " + contactCategory.get_id() + br;
    out.innerHTML += sb;


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