Open XML SDK 2.5 for Office の新機能What's new in the Open XML SDK 2.5 for Office

このトピックでは、Open XML SDK 2.5 for Office に含まれる新機能と強化された機能、既知の問題、および制限事項について説明します。This topic describes the new and improved features included in the Open XML SDK 2.5 for Office in addition to known issues and limitations.


このトピックの内容In this Topic


概要Introduction

Open XML SDK 2.5 は、Open XML ドキュメントをユーザーが作成および操作できるようにするクラスのコレクションです。Open XML ドキュメントとは、Office Open XML File Formats Standard に準拠したドキュメントです。この SDK には、Open XML ドキュメントを直接操作できるアプリケーション プログラム インターフェイスが用意されているので、クライアントとサーバーの両方の運用環境で Office クライアント製品自体を必要とせずに、Open XML ドキュメントを操作できます。SDK は、少量のプログラム コードのみを使用して、複雑な操作を実行する高パフォーマンスのソリューションをクライアント側またはサーバー側で構築できるように設計されています。The Open XML SDK 2.5 is a collection of classes that let you create and manipulate Open XML documents - documents that adhere to the Office Open XML File Formats Standard. Because the SDK provides an application program interface that lets you manipulate Open XML documents directly, you can do so without the need for the Office client products themselves in both client and server operating environments. The SDK is designed to let you build high performance client-side or server-side solutions that perform complex operations using only a small amount of program code.

このリリースの SDK では、ファイル形式のサポートが大幅に拡張され、新機能も追加されています。This release of the SDK greatly extends support for the file formats while adding new features.


システム要件System Requirements

Open XML SDK 2.5 のシステム要件は次のとおりです。The Open XML SDK 2.5 has the following system requirements:

サポートされるオペレーティング システム: Windows 8 プレビュー、Windows 7、Windows Server 2003 Service Pack 2、Windows Server 2008 R2、Windows Server 2008 Service Pack 2、Windows Vista Service Pack 2、Windows XP Service Pack 3Supported operating systems: Windows 8 Preview, Windows 7, Windows Server 2003 Service Pack 2, Windows Server 2008 R2, Windows Server 2008 Service Pack 2, Windows Vista Service Pack 2, Windows XP Service Pack 3

システムの前提条件: .NET Framework のバージョン 4.0 では、ディスクの空き容量が 300 MB を使用するSystem Prerequisites: .NET Framework version 4.0, Up to 300 MB of available disk space


新しいソフトウェア要件New Software Requirements

Open XML SDK 2.5 には .NET Framework 4.0 以降のバージョンが必要です。したがって、サポートされるオペレーティング システムは, .NET Framework 4.0 の要件と同じ内容に更新されています。Open XML SDK 2.5 requires .NET Framework 4.0 or the greater version. Accordingly, the supported operating systems are updated to be the same as the requirements of the .NET Framework 4.0.


Office 2013 プレビューのファイル形式のサポートSupport of Office 2013 Preview File Format

Open XML SDK 1.0 クラスと Open XML SDK 2.0 for Microsoft Office クラスとの互換性を提供するだけでなく、Open XML SDK 2.5 は新しいクラスを提供します。このクラスでは、アプリケーションを記述して作成し、新しい Microsoft Office 2013 機能 (表 1 を参照) の Open XML ファイル拡張子を操作できるようにします。Open XML SDK 2.5 Productivity Tool for Office を使用すると、これらの新しい拡張子を左のウィンドウの Open XML SDK ドキュメント内で参照できます。In addition to offering compatibility with the Open XML SDK 1.0 classes and the Open XML SDK 2.0 for Microsoft Office classes, Open XML SDK 2.5 provides new classes that enable you to write and build applications to manipulate Open XML file extensions of the new Microsoft Office 2013 features (see Table 1). By using the Open XML SDK 2.5 Productivity Tool for Office, those new extensions can be browsed inside the Open XML SDK documentation in the left pane.

表 1. DocumentFormat.OpenXml.Office15 クラスTable 1. DocumentFormat.OpenXml.Office15 classes

クラスClass 説明Description
DocumentFormat.OpenXml.Office15.ExcelDocumentFormat.OpenXml.Office15.Excel 新しいピボットテーブル機能、タイムライン、および Excel のその他の新機能をサポートしますSupports new PivotTable features, timeline, and the other new features of Excel
DocumentFormat.OpenXml.Office15.WordDocumentFormat.OpenXml.Office15.Word 新しいコメント機能 (コメント ウィンドウなど) および Word のその他の新機能をサポートします。たとえば、 CommentEx クラスはコメント作成者を読み取ります。 WebVideoProperty プロパティは、Word ドキュメントにビデオを挿入するために使用されますSupports new Comment features (e.g. Comments pane) and other new features of Word. For example, the CommentEx class reads the comments author; The WebVideoProperty property is used to insert a video in a Word document
DocumentFormat.OpenXml.Office15.PowerPoint, ThemeDocumentFormat.OpenXml.Office15.PowerPoint, Theme コメント箇所ガイド、テーマ ファミリ、および PowerPoint のその他の新機能をサポートしますSupports comment hint, theme family, and the other new features of PowerPoint
DocumentFormat.OpenXml.Office15.DrawingDocumentFormat.OpenXml.Office15.Drawing 新しいグラフ、ピボットグラフ、および図とグラフ関連のその他の新しい機能をサポートしますSupports new Charts, PivotCharts, and other new Drawing and Chart features
DocumentFormat.OpenXml.Office15.WebExtension、WebExtentionPaneDocumentFormat.OpenXml.Office15.WebExtension, WebExtentionPane Office 向けのアプリおよび Office 機能向けの作業ウィンドウ アプリをサポートします。これらのクラスは、Office 向けのアプリを Word と Excel のドキュメント ファイルに挿入したり変更したりするために使用可能です。Supports app for Office and Task Pane app for Office features. The classes are viable for inserting or modifying app for Office into Word and Excel document files

これらの新しいクラスの使用方法を示すコードのサンプルについては、Microsoft Developer Network の Open XML Format SDK フォーラム に投稿される新しい記事を参照してください。For code samples demonstrating how to use these new classes, please refer to new articles posted to Open XML Format SDK Forum in the Microsoft Developer Network.


ISO の厳密型 (Strict) ドキュメント ファイルの読み取りReads ISO Strict Document Files

Open XML SDK 2.5 は、ISO/IEC 29500 厳密型形式のファイルを読み取ることができます。そのドキュメントを開くときは、ドキュメントの内容は Open XML 移行型 (Transitional) 形式のファイルとして認識されます。ファイルを保存するときは、ドキュメントは Open XML 移行型形式のファイルとして保存されます。The Open XML SDK 2.5 can read ISO/IEC 29500 Strict Format files. Its document contents are recognized as an Open XML Transitional Format file when the document is opened. When the file is saved, the document is saved as an Open XML Transitional Format file.

ドキュメントが変更されたとき、またはドキュメントが保存されたときに、Open XML SDK 2.5 は ISO 厳密型形式のファイルを移行型形式のファイルに変換します。ドキュメントが保存または変更されない限り、ドキュメントは ISO 厳密型形式のままです。The Open XML SDK 2.5 converts ISO Strict files to Transitional Formatted files when any changes are made to the document or when the document is saved. Unless the document is saved or modified, the document is left as an ISO Strict Format file.


更新された API の情報Updated API information

Office 2013 のファイルの拡張子のメンバーを拡張するため、 ** <extLst>のメンバーの要素を持たない要素を空に関連する Open XML SDK 2.0 クラス<extLst> ** (例: DocumentFormat.OpenXml.Spreadsheet.PivotFilter:ExtensionList)、Open XML SDK 2.5 (例: DocumentFormat.OpenXml.Spreadsheet.PivotFilter:PivotFilterExtensionList) のExtensionListクラスの新しい形式に更新します。Because the file format extension of Office 2013 extends members of the <extLst> element which did not have any member elements, Open XML SDK 2.0 classes associated with the empty <extLst> (e.g. DocumentFormat.OpenXml.Spreadsheet.PivotFilter:ExtensionList) are updated to the new variants of ExtensionList classes of Open XML SDK 2.5 (e.g. DocumentFormat.OpenXml.Spreadsheet.PivotFilter:PivotFilterExtensionList). 各クラスに次の空ExtensionListは、新しいオープン XMLを子要素のメンバーを含む新しいExtensionListクラスに置き換えられます。The following empty ExtensionList in each class are replaced with a new ExtensionList class including new Off Open XML child element members.

ExtensionList。ExtensionList:

  • DocumentFormat.OpenXml.Drawing.ConnectionShapeLocksDocumentFormat.OpenXml.Drawing.ConnectionShapeLocks

  • DocumentFormat.OpenXml.Drawing.ThemeDocumentFormat.OpenXml.Drawing.Theme

  • DocumentFormat.OpenXml.Drawing.ChartDrawing.NonVisualGroupShapeDrawingPropertiesDocumentFormat.OpenXml.Drawing.ChartDrawing.NonVisualGroupShapeDrawingProperties

  • DocumentFormat.OpenXml.Drawing.Charts.MultiLevelStringReferenceDocumentFormat.OpenXml.Drawing.Charts.MultiLevelStringReference

  • DocumentFormat.OpenXml.Drawing.Charts.NumberReferenceDocumentFormat.OpenXml.Drawing.Charts.NumberReference

  • DocumentFormat.OpenXml.Drawing.Charts.StringReferenceDocumentFormat.OpenXml.Drawing.Charts.StringReference

  • DocumentFormat.OpenXml.Drawing.Charts.SurfaceChartSeriesDocumentFormat.OpenXml.Drawing.Charts.SurfaceChartSeries

  • DocumentFormat.OpenXml.Drawing.Diagrams.DataModelRootDocumentFormat.OpenXml.Drawing.Diagrams.DataModelRoot

  • DocumentFormat.OpenXml.Drawing.Spreadsheet.NonVisualDrawingPropertiesDocumentFormat.OpenXml.Drawing.Spreadsheet.NonVisualDrawingProperties

  • DocumentFormat.OpenXml.Drawing.Spreadsheet.NonVisualGroupShapeDrawingPropertiesDocumentFormat.OpenXml.Drawing.Spreadsheet.NonVisualGroupShapeDrawingProperties

  • DocumentFormat.OpenXml.Office.Drawing.NonVisualGroupDrawingShapePropertiesDocumentFormat.OpenXml.Office.Drawing.NonVisualGroupDrawingShapeProperties

  • DocumentFormat.OpenXml.Office2010.Excel.SlicerCacheDefinitionDocumentFormat.OpenXml.Office2010.Excel.SlicerCacheDefinition

  • DocumentFormat.OpenXml.Office2010.Word.DrawingGroup.NonVisualGroupDrawingShapePropertiesDocumentFormat.OpenXml.Office2010.Word.DrawingGroup.NonVisualGroupDrawingShapeProperties

  • DocumentFormat.OpenXml.Presentation.CommentAuthorDocumentFormat.OpenXml.Presentation.CommentAuthor

  • DocumentFormat.OpenXml.Presentation.NonVisualGroupShapeDrawingPropertiesDocumentFormat.OpenXml.Presentation.NonVisualGroupShapeDrawingProperties

  • DocumentFormat.OpenXml.Spreadsheet.PivotFilterDocumentFormat.OpenXml.Spreadsheet.PivotFilter

  • DocumentFormat.OpenXml.Spreadsheet.QueryTableDocumentFormat.OpenXml.Spreadsheet.QueryTable

ExtensionListWithModification。ExtensionListWithModification:

  • DocumentFormat.OpenXml.Presentation.CommentDocumentFormat.OpenXml.Presentation.Comment

  • DocumentFormat.OpenXml.Presentation.HandoutMasterDocumentFormat.OpenXml.Presentation.HandoutMaster

  • DocumentFormat.OpenXml.Presentation.NotesMasterDocumentFormat.OpenXml.Presentation.NotesMaster

  • DocumentFormat.OpenXml.Presentation.SlideLayoutDocumentFormat.OpenXml.Presentation.SlideLayout

  • DocumentFormat.OpenXml.Presentation.SlideMasterDocumentFormat.OpenXml.Presentation.SlideMaster


非推奨の API の情報Deprecated API Information

次のセクションでは、非推奨の API メンバーについて説明します。The following section discusses deprecated API members:

スマート タグSmart Tags

スマート タグスマート タグが Office 2010 では非推奨となったため、Open XML SDK 2.5 をサポートしていない開いている XML 要素に関連します。Because smart tags were deprecated in Office 2010, the Open XML SDK 2.5 doesn't support smart tag related Open XML elements. Open XML SDK 2.5 でも処理できるスマート タグの要素、不明な要素としてが、Open XML SDK 2.5 の生産性ツールの Office の Office ドキュメントのファイルに無効なタグとして (次の一覧を参照してください)、これらの要素を検証します。The Open XML SDK 2.5 still can process smart tag elements as unknown elements, however the Open XML SDK 2.5 Productivity Tool for Office validates those elements (see the following list) in Office document files as invalid tags.

DocumentFormat.OpenXml.Spreadsheet。DocumentFormat.OpenXml.Spreadsheet:

  • SmartTagDisplayValuesSmartTagDisplayValues

  • SmartTagPropertiesSmartTagProperties

  • SmartTagsSmartTags

  • SmartTagTypeSmartTagType

  • SmartTagTypesSmartTagTypes

DocumentFormat.OpenXml.Wordprocessing。DocumentFormat.OpenXml.Wordprocessing:

  • SaveSmartTagAsXmlSaveSmartTagAsXml

  • SmartTagAttributSmartTagAttribut

  • SmartTagPropertiesSmartTagProperties

  • SmartTagRunSmartTagRun

  • SmartTagTypeSmartTagType

Office 2010 ベータ限定のタグOffice 2010 Beta only tags

Office 2010 のベータ版のみの Open XML タグは非推奨の Open XML SDK 2.0 クラスです。The Open XML SDK 2.0 classes for Office 2010 beta only Open XML tags are deprecated. たとえば、 DocumentFormat.OpenXml.Office2010.Drawing.ChartDrawingDocumentFormat.OpenXml.Office2010.Word、およびDocumentFormat.OpenXml.Office2010.Drawingのベータ版のみの非ビジュアル プロパティが削除されましたOpen XML SDK 2.5 です。For example, the beta only non-visual properties of DocumentFormat.OpenXml.Office2010.Drawing.ChartDrawing, DocumentFormat.OpenXml.Office2010.Word, and DocumentFormat.OpenXml.Office2010.Drawing have been removed from the Open XML SDK 2.5.