Struktur eines WordprocessingML-Dokuments

Artikel
09/24/2014

Letzte Änderung: Freitag, 8. Oktober 2010

Gilt für: Excel 2010 | Office 2010 | PowerPoint 2010 | Word 2010

Inhalt dieses Artikels
Wichtige WordprocessingML-Komponenten
Szenario mit den Mindestkriterien eines Dokuments
Szenario mit den typischen Dokumentkriterien

In diesem Thema werden die Grundstruktur eines WordprocessingML-Dokuments und wichtige Open XML SDK-Klassen behandelt, die zumeist zum Erstellen von WordprocessingML-Dokumenten verwendet werden.

Die Grunddokumentstruktur eines WordProcessingML-Dokuments besteht aus den Elementen <document> und <body>, gefolgt von einem oder mehreren Elementen auf Blockebene, z. B. <p> (Paragraph), das einen Absatz darstellt. Ein Absatz besteht aus einem oder mehreren <r>-Elementen. <r> steht für "run" (Lauf), wobei es sich um einen Textbereich mit gemeinsamen Eigenschaften, z. B. Formatierung, handelt. Ein Lauf enthält ein oder mehrere <t>-Elemente. Das <t>-Element enthält einen Textbereich.

Inhalt dieses Abschnitts

Wichtige WordprocessingML-Komponenten

Szenario mit den Mindestkriterien eines Dokuments

Szenario mit den typischen Dokumentkriterien

Wichtige WordprocessingML-Komponenten

Die Open XML SDK 2.0-API stellt stark typisierte Klassen im DocumentFormat.OpenXML.WordprocessingML-Namespace bereit, die WordprocessingML-Elementen entsprechen.

In der folgenden Tabelle werden einige wichtige WordprocessingML-Elemente, die WordprocessingML-Dokumentpaketkomponente, der das Element entspricht (sofern zutreffend), und die verwaltete Klasse aufgelistet, die das Element in der Open XML SDK 2.0-API darstellt.

Paketkomponente	WordprocessingML-Element	Open XML SDK 2.0-Klasse	Beschreibung
Hauptdokument	document	Document	Das Stammelement des Hauptdokumentteils.
Kommentare	comments	Comments	Das Stammelement des Kommentarteils.
Dokumenteinstellungen	settings	Settings	Das Stammelement des Dokumenteinstellungsteils.
Endnoten	endnotes	Endnotes	Das Stammelement des Endnotenteils.
Fußzeile	ftr	Footer	Das Stammelement des Fußzeilenteils.
Fußnoten	footnotes	Footnotes	Das Stammelement des Fußnotenteils.
Glossardokument	glossaryDocument	GlossaryDocument	Das Stammelement des Glossardokumentteils.
Kopfzeile	hdr	Header	Das Stammelement des Kopfzeilenteils.
Formatvorlagendefinitionen	styles	Styles	Das Stammelement des Teils mit Formatvorlagendefinitionen.

Szenario mit den Mindestkriterien eines Dokuments

Ein WordprocessingML-Dokument ist gemäß eines Textabschnittkonzepts strukturiert. Ein Textabschnitt ist ein Inhaltsbereich eines WordprocessingML-Dokuments. WordprocessingML-Textabschnitte enthalten Folgendes:

Kommentar
Endnote
Fußzeile
Fußnote
Rahmen, Glossardokument
Kopfzeile
Hauptartikel
Unterdokument
Textfeld

In einem WordprocessingML-Dokument müssen nicht alle Textabschnitte vorhanden sein. Das einfachste gültige WordprocessingML-Dokument benötigt nur einen einzelnen Textabschnitt, den Hauptdokumentabschnitt. In WordprocessingML wird der Hauptdokumentabschnitt vom Hauptdokumentteil dargestellt. Fügen Sie zum Erstellen eines gültigen WordprocessingML-Dokuments mithilfe von Code dem Dokument zumindest einen Hauptdokumentteil hinzu.

Die folgenden Informationen aus der Spezifikation ISO/IEC 29500 bieten eine Einführung in die WordprocessingML-Elemente, die im Hauptdokumentteil erforderlich sind, um die Mindestkriterien dieses Szenarios zu erfüllen.

Der Hauptdokumentabschnitt des einfachsten WordprocessingML-Dokuments besteht aus den folgenden XML-Elementen:

document – Das Stammelement eines WordprocessingML-Hauptdokumentteils, das den Hauptdokumentabschnitt definiert.

body – Der Container der Auflistung der Strukturen auf Blockebene, die den Haupttextabschnitt bilden.

p – Ein Absatz (Paragraph).

r – Ein Lauf (Run).

t – Ein Textbereich.

Open XML SDK 2.0-Codebeispiel

Im folgenden Code wird mithilfe des Open XML SDK 2.0 ein einfaches WordprocessingML-Dokument erstellt, das den Text "Hello, World!" enthält.

public static void CreateWordDoc(string filepath, string msg)
{
    using (WordprocessingDocument doc = WordprocessingDocument.Create(filepath, DocumentFormat.OpenXml.WordprocessingDocumentType.Document))
    {
        // Add a main document part. 
        MainDocumentPart mainPart = doc.AddMainDocumentPart();

        // Create the document structure and add some text.
        mainPart.Document = new Document();
        Body body = mainPart.Document.AppendChild(new Body());
        Paragraph para = body.AppendChild(new Paragraph());
        Run run = para.AppendChild(new Run());

        // String msg contains the text, "Hello, Word!"
        run.AppendChild(new Text(msg));
    }
}

Public Shared Sub CreateWordDoc(filepath As String, msg As String)
    Using doc As WordprocessingDocument = WordprocessingDocument.Create(filepath, DocumentFormat.OpenXml.WordprocessingDocumentType.Document)
        ' Add a main document part. 
        Dim mainPart As MainDocumentPart = doc.AddMainDocumentPart()

        ' Create the document structure and add some text.
        mainPart.Document = New Document()
        Dim body As Body = mainPart.Document.AppendChild(New Body())
        Dim para As Paragraph = body.AppendChild(New Paragraph())
        Dim run As Run = para.AppendChild(New Run())

        ' String msg contains the text, "Hello, Word!"
        run.AppendChild(New Text(msg))
    End Using
End Sub

Generierter WordprocessingML-Code

Nach Ausführung des Open XML SDK 2.0-Codes im vorherigen Abschnitt zum Generieren eines Dokuments können Sie den im ZIP-Paket enthaltenen WordprocessingML-XML-Code untersuchen. Benennen Sie zum Anzeigen des ZIP-Pakets die Erweiterung des Dokuments mit den Mindestkriterien von DOCX in ZIP um. Das ZIP-Paket enthält die Teile, die das Dokument bilden. Da in diesem Fall der Code nur zum Erstellen eines WordprocessingML-Dokuments mit den Mindestkriterien gedient hat, gibt es nur einen einzigen Teil, den Hauptdokumentteil. Die folgende Abbildung zeigt die Struktur unter dem Word-Ordner des ZIP-Pakets eines Dokuments mit den Mindestkriterien mit einer einzigen Textzeile.GrafikplatzhalterDie Datei document.xml entspricht dem WordprocessingML-Hauptdokumentteil. Es ist dieser Teil, der den Inhalt des Hauptabschnitts des Dokuments enthält. Der folgende XML-Code wird in der Datei document.xml generiert, wenn Sie den Open XML SDK 2.0-Code im vorherigen Abschnitt ausführen.

<?xml version="1.0" encoding="utf-8"?>
<w:document xmlns:w="https://schemas.openxmlformats.org/wordprocessingml/2006/main">
  <w:body>
    <w:p>
      <w:r>
        <w:t>Hello, Word!</w:t>
      </w:r>
    </w:p>
  </w:body>
</w:document

Szenario mit den typischen Dokumentkriterien

Ein typisches Dokument ist kein leeres Dokument mit den Mindestkriterien, sondern enthält beispielsweise Kommentare, eine Kopf- und Fußzeile sowie Fuß- und Endnoten. Jeder dieser zusätzlichen Teile ist im ZIP-Paket des Textverarbeitungsdokuments enthalten.

Die folgende Abbildung zeigt viele der Teile, die Sie normalerweise in einem typischen Dokument finden.

Abbildung 1. Struktur eines typischen Dokuments

Struktur eines WordprocessingML-Dokuments

Freigeben über

Struktur eines WordprocessingML-Dokuments

Wichtige WordprocessingML-Komponenten

Szenario mit den Mindestkriterien eines Dokuments

Open XML SDK 2.0-Codebeispiel

Generierter WordprocessingML-Code

Szenario mit den typischen Dokumentkriterien

Zusätzliche Ressourcen