方法 : アプリケーション レベルのアドインを使用してドキュメントにカスタム XML 部分を追加する
アプリケーション レベルのアドイン内にカスタム XML 部分を作成することにより、以下の種類のドキュメントに XML データを格納できます。
Microsoft Office Excel ブック
Microsoft Office Word 文書
Microsoft Office PowerPoint プレゼンテーション
詳細については、「カスタム XML 部分の概要」を参照してください。
適用されます: は、このトピックの情報次のアプリケーションのアプリケーション レベルのプロジェクトを適用します: Excel 2010; 2010; PowerPoint Word 2010。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
Excel ブックにカスタム XML 部分を追加するには
ブック内の CustomXMLParts コレクションに CustomXMLPart オブジェクトを追加します。CustomXMLPart には、ブックに格納する XML 文字列が含まれています。
次のコード例では、特定のブックにカスタム XML 部分を追加します。
Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook) Dim xmlString As String = _ "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _ "<employees https://schemas.microsoft.com/vsto/samples"">" & _ "<employee>" & _ "<name>Karina Leal</name>" & _ "<hireDate>1999-04-01</hireDate>" & _ "<title>Manager</title>" & _ "</employee>" & _ "</employees>" Dim employeeXMLPart As Office.CustomXMLPart = _ workbook.CustomXMLParts.Add(xmlString) End Sub
private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook) { string xmlString = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" + "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" + "<employee>" + "<name>Karina Leal</name>" + "<hireDate>1999-04-01</hireDate>" + "<title>Manager</title>" + "</employee>" + "</employees>"; Office.CustomXMLPart employeeXMLPart = workbook.CustomXMLParts.Add(xmlString, missing); }
Excel 用のアプリケーション レベルのプロジェクト内の ThisAddIn クラスに AddCustomXmlPartToWorkbook メソッドを追加します。
このメソッドをプロジェクト内の他のコードから呼び出します。たとえば、ユーザーがブックを開いたときにカスタム XML 部分を作成するには、このメソッドを WorkbookOpen イベントのイベント ハンドラーから呼び出します。
Word 文書にカスタム XML 部分を追加するには
文書内の CustomXMLParts コレクションに CustomXMLPart オブジェクトを追加します。CustomXMLPart には、文書に格納する XML 文字列が含まれます。
次のコード例では、特定の文書にカスタム XML 部分を追加します。
Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document) Dim xmlString As String = _ "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _ "<employees https://schemas.microsoft.com/vsto/samples"">" & _ "<employee>" & _ "<name>Karina Leal</name>" & _ "<hireDate>1999-04-01</hireDate>" & _ "<title>Manager</title>" & _ "</employee>" & _ "</employees>" Dim employeeXMLPart As Office.CustomXMLPart = _ document.CustomXMLParts.Add(xmlString) End Sub
private void AddCustomXmlPartToActiveDocument(Word.Document document) { string xmlString = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" + "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" + "<employee>" + "<name>Karina Leal</name>" + "<hireDate>1999-04-01</hireDate>" + "<title>Manager</title>" + "</employee>" + "</employees>"; Office.CustomXMLPart employeeXMLPart = document.CustomXMLParts.Add(xmlString, missing); }
Word 用のアプリケーション レベルのプロジェクト内の ThisAddIn クラスに AddCustomXmlPartToDocument メソッドを追加します。
このメソッドをプロジェクト内の他のコードから呼び出します。たとえば、ユーザーが文書を開いたときにカスタム XML 部分を作成するには、このメソッドを DocumentOpen イベントのイベント ハンドラーから呼び出します。
PowerPoint プレゼンテーションにカスタム XML 部分を追加するには
プレゼンテーション内の CustomXMLParts コレクションに CustomXMLPart オブジェクトを追加します。CustomXMLPart には、プレゼンテーション内に格納する XML 文字列が含まれます。
次のコード例では、特定のプレゼンテーションにカスタム XML 部分を追加します。
Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation) Dim xmlString As String = _ "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _ "<employees https://schemas.microsoft.com/vsto/samples"">" & _ "<employee>" & _ "<name>Karina Leal</name>" & _ "<hireDate>1999-04-01</hireDate>" & _ "<title>Manager</title>" & _ "</employee>" & _ "</employees>" Dim employeeXMLPart As Office.CustomXMLPart = _ presentation.CustomXMLParts.Add(xmlString) End Sub
private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation) { string xmlString = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" + "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" + "<employee>" + "<name>Karina Leal</name>" + "<hireDate>1999-04-01</hireDate>" + "<title>Manager</title>" + "</employee>" + "</employees>"; Office.CustomXMLPart employeeXMLPart = presentation.CustomXMLParts.Add(xmlString, missing); }
PowerPoint 用のアプリケーション レベルのプロジェクト内の ThisAddIn クラスに AddCustomXmlPartToPresentation メソッドを追加します。
このメソッドをプロジェクト内の他のコードから呼び出します。たとえば、ユーザーがプレゼンテーションを開いたときにカスタム XML 部分を作成するには、このメソッドを AfterPresentationOpen イベントのイベント ハンドラーから呼び出します。
信頼性の高いプログラミング
簡略化のために、この例ではメソッドにローカル変数として定義された XML 文字列を使用しています。通常は、ファイルやデータベースなどの外部ソースから XML 文字列を取得する必要があります。
参照
処理手順
方法 : ドキュメント レベルのカスタマイズにカスタム XML 部分を追加する