Run Klasse

Definition

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Paket:

DocumentFormat.OpenXml v3.0.1

Phonetische Führungstextausführung.

Diese Klasse ist in Office 2007 und höher verfügbar.

Wenn das Objekt als XML serialisiert wird, lautet der qualifizierte Name w:r.

public class Run : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Run = class
    inherit OpenXmlCompositeElement

Public Class Run
Inherits OpenXmlCompositeElement

Vererbung

Object

OpenXmlElement

OpenXmlCompositeElement

Run

Beispiele

Im folgenden Beispiel wird ein Textverarbeitungsdokument erstellt und der Text "Hello, World!" hinein.

using System;  
using DocumentFormat.OpenXml;  
using DocumentFormat.OpenXml.Packaging;          
using DocumentFormat.OpenXml.Wordprocessing;  

namespace RunEx  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // Create a document by path, and write some text in it.  
            string fileName = @"C:\Users\Public\Documents\RunEx.docx";  
            string txt = "Hello, world!";  

            // Create the Word document.   
            WordprocessingDocument wordprocessingDocument =  
                WordprocessingDocument.Create(fileName,   
                    WordprocessingDocumentType.Document);  

            // Create a MainDocumentPart instance.  
            MainDocumentPart mainDocumentPart =   
                wordprocessingDocument.AddMainDocumentPart();  
            mainDocumentPart.Document = new Document();  

            // Create a Document instance.  
            Document document = mainDocumentPart.Document;  

            // Create a Body instance.  
            Body body = document.AppendChild(new Body());  

            // Create a Paragraph instance.  
            Paragraph para = body.AppendChild(new Paragraph());  

            // Create a Run instance.  
            Run run = para.AppendChild(new Run());  

            // Add Text to the Run element.  
            run.AppendChild(new Text(txt));  

            // Close the document handle  
            wordprocessingDocument.Close();  

            Console.WriteLine("The document has been created. Press any key.");  
            Console.ReadKey();  
        }  
    }     
}  

Imports DocumentFormat.OpenXml  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Wordprocessing  

Module Module1  
    Sub Main(ByVal args As String())  
        ' Create a document by path, and write some text in it.  
        Dim fileName As String = "C:\Users\Public\Documents\RunEx.docx"  
        Dim txt As String = "Hello, world!"  

        ' Create the Word document.   
        Dim wordprocessingDocument As WordprocessingDocument = _  
            wordprocessingDocument.Create(fileName, WordprocessingDocumentType.Document)  

        ' Create a MainDocumentPart instance.  
        Dim mainDocumentPart As MainDocumentPart = _  
        wordprocessingDocument.AddMainDocumentPart()  
        mainDocumentPart.Document = New Document()  

        ' Create a Document instance.  
        Dim document As Document = mainDocumentPart.Document  

        ' Create a Body instance.  
        Dim body As Body = document.AppendChild(New Body())  

        ' Create a Paragraph instance.  
        Dim para As Paragraph = body.AppendChild(New Paragraph())  

        ' Create a Run instance.  
        Dim run As Run = para.AppendChild(New Run())  

        ' Add Text to the Run element.  
        run.AppendChild(New Text(txt))  

        ' Close the document handle  
        wordprocessingDocument.Close()  

        Console.WriteLine("The document has been created. Press any key.")  
        Console.ReadKey()  
    End Sub  
End Module  

Hinweise

[ISO/IEC 29500-1 1. Auflage]

r (Textausführung)

Dieses Element gibt eine Inhaltsausführung im übergeordneten Feld, Hyperlink, benutzerdefiniertes XML-Element, strukturiertes Dokumenttag, Smarttag oder Absatz an.

Der Inhalt einer Ausführung in einem WordprocessingML-Dokument muss aus einer beliebigen Kombination von Ausführungsinhalten bestehen.

[Beispiel: Betrachten Sie einen einfachen WordprocessingML-Absatz mit zwei Ausführungen. Diese Ausführung würde wie folgt ausgedrückt:

<w:document>  
  <w:body>  
    <w:p>  
      <w:r>  
        <w:t>Text</w:t>  
      </w:r>  
      <w:fldSimple w:instr="AUTHOR">  
        <w:r>  
          <w:t>Author Name</w:t>  
        </w:r>  
      </w:fldSimple>  
    </w:p>  
  </w:body>  
</w:document>  

Das r-Element ist der Container für den gesamten Inhalt der Ausführung, der in diesem Beispiel sowohl eine Ausführung im Absatz als auch eine Ausführung innerhalb eines einfachen Felds enthält. Ende des Beispiels]

Übergeordnete Elemente
bdo (§17.3.2.3); customXml (§17.5.1.3); del (§17.13.5.14); dir (§17.3.2.8); fldSimple (§17.16.19); Link (§17.16.22); ins (§17.13.5.18); moveFrom (§17.13.5.22); moveTo (§17.13.5.25); p (§17.3.1.22); rt (§17.3.3.24); rubyBase (§17.3.3.27); sdtContent (§17.5.2.36); smartTag (§17.5.1.9)

Untergeordnete Elemente	Subclause
annotationRef (Kommentarinformationsblock)	§17.13.4.1
br (Pause)	§17.3.3.1
commentReference (Verweiszeichen für Kommentarinhalt)	§17.13.4.5
contentPart (Inhaltsteil)	§17.3.3.2
continuationSeparator (Fortsetzungstrennzeichen)	§17.11.1
cr (Wagenrücklauf)	§17.3.3.4
dayLong (Datumsblock – Format für lange Tage)	§17.3.3.5
dayShort (Datumsblock – Kurzes Tagesformat)	§17.3.3.6
delInstrText (Gelöschte Feldcode)	§17.16.13
delText (Gelöschter Text)	§17.3.3.7
Zeichnen (DrawingML-Objekt)	§17.3.3.9
endnoteRef (Endnotenverweiszeichen)	§17.11.6
endnoteReference (Endnotenreferenz)	§17.11.7
fldChar (Komplexes Feldzeichen)	§17.16.18
footnoteRef (Fußnotenverweiszeichen)	§17.11.13
footnoteReference (Fußnotenverweis)	§17.11.14
instrText (Feldcode)	§17.16.23
lastRenderedPageBreak (Position des letzten berechneten Seitenumbruchs)	§17.3.3.13
monthLong (Datumsblock – Langes Monatsformat)	§17.3.3.15
monthShort (Datumsblock – Kurzes Monatsformat)	§17.3.3.16
noBreakHyphen (Non Breaking Hyphen Character)	§17.3.3.18
Objekt (eingebettetes Objekt)	§17.3.3.19
pgNum (Seitenzahlenblock)	§17.3.3.22
ptab (Tabstoppzeichen absolute Position)	§17.3.3.23
rPr (Ausführungseigenschaften)	§17.3.2.28
ruby (Phonetischer Leitfaden)	§17.3.3.25
Trennzeichen (Fußnoten-/Endnotentrennzeichen)	§17.11.23
softHyphen (optionaler Bindestrich)	§17.3.3.29
sym (Symbolzeichen)	§17.3.3.30
t (Text)	§17.3.3.31
Tab (Tabstoppzeichen)	§17.3.3.32
yearLong (Datumsblock - Langes Jahrformat)	§17.3.3.33
yearShort (Datumsblock – Kurzes Jahrformat)	§17.3.3.34

Attribute	Beschreibung
rsidDel (Revisionsbezeichner für ausführende Löschung)	Gibt einen eindeutigen Bezeichner an, mit dem die Bearbeitungssitzung nachverfolgt wird, als die Ausführung aus dem Standard Dokuments gelöscht wurde. Alle rsid*-Attribute in diesem Dokument mit demselben Wert geben an, dass diese Bereiche während derselben Bearbeitungssitzung (Zeit zwischen nachfolgenden Speicheraktionen) geändert wurden. Ein Producer kann den Wert der Revisionsspeicher-ID erhöhen, um nachfolgende Bearbeitungssitzungen anzugeben, um die Reihenfolge der Änderungen im Verhältnis zu anderen Änderungen in diesem Dokument anzugeben. Die möglichen Werte für dieses Attribut werden durch den ST_LongHexNumber einfachen Typ (§17.18.50) definiert.
rsidR (Revisionsbezeichner für Run)	Gibt einen eindeutigen Bezeichner an, der zum Nachverfolgen der Bearbeitungssitzung verwendet wird, als die Ausführung dem Standard Dokument hinzugefügt wurde. Alle rsid*-Attribute in diesem Dokument mit demselben Wert geben an, dass diese Bereiche während derselben Bearbeitungssitzung (Zeit zwischen nachfolgenden Speicheraktionen) geändert wurden. Ein Producer kann den Wert der Revisionsspeicher-ID erhöhen, um nachfolgende Bearbeitungssitzungen anzugeben, um die Reihenfolge der Änderungen im Verhältnis zu anderen Änderungen in diesem Dokument anzugeben. Die möglichen Werte für dieses Attribut werden durch den ST_LongHexNumber einfachen Typ (§17.18.50) definiert.
rsidRPr (Revisionsbezeichner für Ausführungseigenschaften)	Gibt einen eindeutigen Bezeichner an, der verwendet wird, um die Bearbeitungssitzung nachzuverfolgen, als die Ausführungseigenschaften zuletzt im Standard-Dokument geändert wurden. Alle rsid*-Attribute in diesem Dokument mit demselben Wert geben an, dass diese Bereiche während derselben Bearbeitungssitzung (Zeit zwischen nachfolgenden Speicheraktionen) geändert wurden. Ein Producer kann den Wert der Revisionsspeicher-ID erhöhen, um nachfolgende Bearbeitungssitzungen anzugeben, um die Reihenfolge der Änderungen im Verhältnis zu anderen Änderungen in diesem Dokument anzugeben. Die möglichen Werte für dieses Attribut werden durch den ST_LongHexNumber einfachen Typ (§17.18.50) definiert.

[Hinweis: Die W3C-XML-Schemadefinition des Inhaltsmodells (CT_R) dieses Elements befindet sich in §A.1. Ende des Hinweises]

ISO/IEC29500: 2008.

Konstruktoren

Run()	Initialisiert eine neue instance der Run-Klasse.
Run(IEnumerable<OpenXmlElement>)	Initialisiert eine neue instance der Run-Klasse mit den angegebenen untergeordneten Elementen.
Run(OpenXmlElement[])	Initialisiert eine neue instance der Run-Klasse mit den angegebenen untergeordneten Elementen.
Run(String)	Initialisiert eine neue instance der Run-Klasse aus äußerem XML.

Eigenschaften

ChildElements	Ruft alle untergeordneten Knoten des aktuellen Elements ab. (Geerbt von OpenXmlElement)
ExtendedAttributes	Ruft alle erweiterten Attribute (Attribute, die im Schema nicht definiert sind) des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Features	Ruft ein IFeatureCollection für das aktuelle Element ab. Diese Featuresammlung ist schreibgeschützt, erbt jedoch Features von ihrem übergeordneten Teil und Paket, falls verfügbar. (Geerbt von OpenXmlElement)
FirstChild	Ruft das erste untergeordnete Element des aktuellen OpenXmlElement-Elements ab. (Geerbt von OpenXmlCompositeElement)
HasAttributes	Ruft einen Wert ab, der angibt, ob das aktuelle Element über Attribute verfügt. (Geerbt von OpenXmlElement)
HasChildren	Ruft einen Wert ab, der angibt, ob das aktuelle Element über untergeordnete Elemente verfügt. (Geerbt von OpenXmlCompositeElement)
InnerText	Ruft die verketteten Werte des aktuellen Knotens und aller untergeordneten Elemente ab oder legt diese fest. (Geerbt von OpenXmlCompositeElement)
InnerXml	Ruft das Markup ab, das nur die untergeordneten Knoten des aktuellen Knotens darstellt, oder legt dieses fest. (Geerbt von OpenXmlCompositeElement)
LastChild	Ruft das letzte untergeordnete Element des aktuellen OpenXmlElement-Elements ab. Gibt null (Nothing in Visual Basic) zurück, wenn kein solches OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlCompositeElement)
LocalName	Ruft den lokalen Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
MCAttributes	Ruft die Markupkompatibilitätsattribute ab oder legt sie fest. Gibt NULL zurück, wenn für das aktuelle Element keine Markupkompatibilitätsattribute definiert sind. (Geerbt von OpenXmlElement)
NamespaceDeclarations	Ruft alle im aktuellen Element definierten Namespacedeklarationen ab. Gibt einen leeren Enumerator zurück, wenn keine Namespacedeklaration vorhanden ist. (Geerbt von OpenXmlElement)
NamespaceUri	Ruft den Namespace-URI des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OpenXmlElementContext	Ruft den OpenXmlElementContext des aktuellen Elements ab. (Geerbt von OpenXmlElement)
OuterXml	Ruft das Markup ab, das das aktuelle Element und alle untergeordneten Elemente darstellt. (Geerbt von OpenXmlElement)
Parent	Ruft das übergeordnete Element des aktuellen Elements ab. (Geerbt von OpenXmlElement)
Prefix	Ruft das Namespacepräfix des aktuellen Elements ab. (Geerbt von OpenXmlElement)
RsidRunAddition	Revisionsbezeichner für Die Ausführung Stellt das folgende Attribut im Schema dar: w:rsidR
RsidRunDeletion	Revisionsbezeichner für "Run Delete" (Löschvorgang ausführen) Stellt das folgende Attribut im Schema dar: w:rsidDel
RsidRunProperties	Revisionsbezeichner für Ausführungseigenschaften Stellt das folgende Attribut im Schema dar: w:rsidRPr
RunProperties	Eigenschaften ausführen. Stellt das folgende Elementtag im Schema dar: w:rPr.
XmlQualifiedName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)
XName	Ruft den qualifizierten Namen des aktuellen Elements ab. (Geerbt von OpenXmlElement)

Methoden

AddAnnotation(Object)	Fügt der Liste der Anmerkungen des aktuellen OpenXmlElement-Elements ein -Objekt hinzu. (Geerbt von OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Fügt dem Element das angegebene Element hinzu, wenn es sich um ein bekanntes untergeordnetes Element handelt. Dadurch wird das -Element an der richtigen Position gemäß dem Schema hinzugefügt. (Geerbt von OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Fügt dem aktuellen Knoten eine Namespacedeklaration hinzu. (Geerbt von OpenXmlElement)
Ancestors()	Listet alle Vorgängerelemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Ancestors<T>()	Listet nur die Vorgänger des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
Annotation(Type)	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotation<T>()	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus dem aktuellen OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations(Type)	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Annotations<T>()	Ruft eine Auflistung von Anmerkungen mit dem angegebenen Typ für das aktuelle OpenXmlElement-Element ab. (Geerbt von OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Fügt jedes Element aus einer Liste von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
Append(OpenXmlElement[])	Fügt jedes Element aus einem Array von Elementen an das Ende der Liste der untergeordneten Elemente des aktuellen Elements an. (Geerbt von OpenXmlElement)
AppendChild<T>(T)	Fügt das angegebene Element am Ende der Liste der untergeordneten Knoten des aktuellen Elements an. (Geerbt von OpenXmlCompositeElement)
ClearAllAttributes()	Löscht alle Attribute, einschließlich bekannter und erweiterter Attribute. (Geerbt von OpenXmlElement)
Clone()	Erstellt ein Duplikat des aktuellen Knotens. (Geerbt von OpenXmlElement)
CloneNode(Boolean)	Erstellt ein Duplikat dieses Knotens.
Descendants()	Listet alle Nachfolger des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Descendants<T>()	Listet alle Nachfolger des aktuellen Elements vom Typ T auf. (Geerbt von OpenXmlElement)
Elements()	Listet alle untergeordneten Elemente des aktuellen Elements auf. (Geerbt von OpenXmlElement)
Elements<T>()	Listet nur die untergeordneten Elemente des aktuellen Elements auf, die den angegebenen Typ aufweisen. (Geerbt von OpenXmlElement)
ElementsAfter()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element folgen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
ElementsBefore()	Listet alle gleichgeordneten Elemente auf, die dem aktuellen Element vorausgehen und dasselbe übergeordnete Element wie das aktuelle Element haben. (Geerbt von OpenXmlElement)
GetAttribute(String, String)	Ruft ein Open XML-Attribut mit dem angegebenen Tagnamen und Namespace-URI ab. (Geerbt von OpenXmlElement)
GetAttributes()	Ruft eine Liste ab, die eine Kopie aller Attribute enthält. (Geerbt von OpenXmlElement)
GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)
GetFirstChild<T>()	Sucht das erste untergeordnete Element im Typ T. (Geerbt von OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar nach dem angegebenen Verweiselement ein. (Geerbt von OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Fügt das angegebene Element unmittelbar nach dem aktuellen Element ein. (Geerbt von OpenXmlElement)
InsertAt<T>(T, Int32)	Fügt das angegebene Element am angegebenen Index der untergeordneten Elemente des aktuellen Elements ein. (Geerbt von OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Fügt das angegebene Element unmittelbar vor dem angegebenen Verweiselement ein. (Geerbt von OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Fügt das angegebene Element unmittelbar vor dem aktuellen Element ein. (Geerbt von OpenXmlElement)
IsAfter(OpenXmlElement)	Bestimmt, ob das aktuelle Element nach einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
IsBefore(OpenXmlElement)	Bestimmt, ob das aktuelle Element vor einem angegebenen Element in Dokumentreihenfolge angezeigt wird. (Geerbt von OpenXmlElement)
LookupNamespace(String)	Löst das Namespacepräfix im Kontext des aktuellen Knotens auf. (Geerbt von OpenXmlElement)
LookupPrefix(String)	Sucht das entsprechende Präfix für einen Namespace-URI im aktuellen Elementbereich. (Geerbt von OpenXmlElement)
NextSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
NextSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der auf das aktuelle OpenXmlElement-Element folgt. Gibt null (Nothing in Visual Basic) zurück, wenn kein nächstes OpenXmlElement vorhanden ist. (Geerbt von OpenXmlElement)
PrependChild<T>(T)	Fügt das angegebene Element am Anfang der Liste der untergeordneten Knoten des aktuellen Elements ein. (Geerbt von OpenXmlCompositeElement)
PreviousSibling()	Ruft das OpenXmlElement-Element ab, das unmittelbar vor dem aktuellen OpenXmlElement-Element steht. Gibt null (Nothing in Visual Basic ) zurück, wenn kein vorangehendes OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
PreviousSibling<T>()	Ruft das OpenXmlElement-Element mit dem angegebenen Typ ab, der dem aktuellen OpenXmlElement vorangestellt ist. Gibt null (Nothing in Visual Basic) zurück, wenn kein vorheriges OpenXmlElement-Element vorhanden ist. (Geerbt von OpenXmlElement)
Remove()	Entfernt das aktuelle Element aus dem übergeordneten Element. (Geerbt von OpenXmlElement)
RemoveAllChildren()	Entfernt alle untergeordneten Elemente des aktuellen Elements. (Geerbt von OpenXmlCompositeElement)
RemoveAllChildren<T>()	Entfernen Sie alle untergeordneten Elemente des aktuellen Elements vom Typ T. (Geerbt von OpenXmlElement)
RemoveAnnotations(Type)	Entfernt die Anmerkungen des angegebenen Typs aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAnnotations<T>()	Entfernt die Anmerkungen mit dem angegebenen Typ aus dem aktuellen OpenXmlElement-Element. (Geerbt von OpenXmlElement)
RemoveAttribute(String, String)	Entfernt das Attribut aus dem aktuellen Element. (Geerbt von OpenXmlElement)
RemoveChild<T>(T)	Entfernt das angegebene untergeordnete Element. (Geerbt von OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Entfernt die Namespacedeklaration für das angegebene Präfix. Entfernt nichts, wenn kein Präfix vorhanden ist. (Geerbt von OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Ersetzt eines der untergeordneten Elemente des aktuellen Elements durch ein anderes OpenXmlElement-Element. (Geerbt von OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	Legt ein Attribut auf das angegebene Element fest. Wenn das Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn es sich bei dem Attribut um ein erweitertes Attribut handelt, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Legt eine Reihe von Attributen für das -Element fest. Wenn ein Attribut ein bekanntes Attribut ist, wird der Wert des Attributs festgelegt. Wenn ein Attribut ein erweitertes Attribut ist, wird das "openxmlAttribute" der Liste der erweiterten Attribute hinzugefügt. (Geerbt von OpenXmlElement)
WriteTo(XmlWriter)	Speichert den aktuellen Knoten im angegebenen XmlWriter. (Geerbt von OpenXmlElement)

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Phonetische Führungstextausführung. Diese Klasse ist in Office 2007 und höher verfügbar. Wenn das Objekt als XML serialisiert wird, lautet der qualifizierte Name w:r. (Geerbt von OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Gibt einen Enumerator zurück, der die untergeordnete Auflistung durchläuft. (Geerbt von OpenXmlElement)