File object

Represents the document file associated with an Office Add-in.

Hosts: PowerPoint, Word
Available in Requirement set File
Last changed in 1.1



Name Description
size Gets the document file size in bytes.
sliceCount Gets the number of slices into which the file is divided.


Name Description
closeAsync Closes the document file.
getSliceAsync Returns the specified slice.


Access the File object with the AsyncResult.value property in the callback function passed to the Document.getFileAsync method.

Support details

A capital Y in the following matrix indicates that this object is supported in the corresponding Office host application. An empty cell indicates that the Office host application doesn't support this object.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.

Office for Windows desktop Office Online (in browser) Office for iPad
PowerPoint Y Y Y
Word Y Y
Available in requirement set File
Add-in types Content, task pane
Library Office.js
Namespace Office

Support history

Version Changes
1.1 Added support for PowerPoint and Word in Office for iPad.
1.0 Introduced