This topic has not yet been rated - Rate this topic

CustomXmlParts.getByNamespaceAsync method (apps for Office)

apps for SharePoint

Published: February 26, 2013

Asynchronously gets an array of custom XML parts that match the specified namespace.

Office.context.document.customXmlParts.getByNamespaceAsync(ns [, options], callback);
ns

Type: string

The namespace URI. Required.

options

Type:object

Specifies the following optional parameters.

asyncContext

Type: array, Boolean, null, number, object, string, or undefined

A user-defined item of any type that is returned in the AsyncResult object without being altered. Optional.

callback

Type: object

A function that is invoked when the callback returns, whose only parameter is of type AsyncResult. Optional.

When the function you passed to the callback parameter executes, it receives an AsyncResult object that you can access from the callback function's only parameter. Use the AsyncResult.value property to access an array of CustomXMLPart objects that match the specified namespace. To determine the success or failure of the operation, use the AsyncResult.status property. If the operation failed, use the AsyncResult.error property to access an Error object that provides information about the error. If you passed a user-defined object to the asyncContext parameter, use the AsyncResult.asyncContext property to access that object.

function showXMLPartsInNamespace() {
    Office.context.document.customXmlParts.getByNamespaceAsync("http://tempuri.org", function (eventArgs) {
        write("Found " + eventArgs.value.length + " parts with this namespace");
    }); 
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

Supported clients

Word 2013

Library

Office.js

Namespace

Office

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.