Paragraph 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 Paragraph 类。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 w：p。

public class Paragraph : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Paragraph = class
    inherit OpenXmlCompositeElement

Public Class Paragraph
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

Paragraph

示例

下面的代码示例打开现有的字处理文件，并向其中写入文本。

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

namespace ParagraphEx  
{  
    class Program  
    {  
        // Open an existing file and add text to it.  
        static void Main(string[] args)  
        {  
           string fileName = @"C:\Users\Public\Documents\ParagraphEx.docx";  

           // Open the file for editing.  
           using (WordprocessingDocument wordprocessingDocument =  
               WordprocessingDocument.Open(fileName, true))  
           {  
                    // Get document element of the Package.  
                    Document document =   
                        wordprocessingDocument.MainDocumentPart.Document;  

                    // Add new text to the file.   
                    document.Append(new Body  
                        (new Paragraph  
                            (new Run  
                                (new Text  
                                    ("This is the inserted text by the example.")))));  
                    Console.WriteLine("All done. Press a key.");  
                    Console.ReadKey();  
           }  
        }  
    }  
}  

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

Module Module1  

    ' Open an existing file and add text to it.  
    Sub Main()  
        Dim fileName As String = "C:\Users\Public\Documents\ParagraphEx.docx"  

        ' Open the file for editing.  
        Using wordprocessingDocument As WordprocessingDocument = wordprocessingDocument.Open(fileName, True)  
            ' Get document element of the Package.  
            Dim document As Document = wordprocessingDocument.MainDocumentPart.Document  

            ' Add new text to the file.   
            document.Append(New Body _  
                            (New Paragraph _  
                             (New Run _  
                              (New Text _  
                               ("This is the inserted text by the example.")))))  
            Console.WriteLine("All done. Press a key.")  
            Console.ReadKey()  
        End Using  
    End Sub  
End Module  

注解

[ISO/IEC 29500-1 第 1 版]

p (段落)

此元素指定文档中内容的段落。

WordprocessingML 文档中段落的内容应由以下四种内容的任意组合组成：

• 段落属性

• 注释 (书签、批注、修订)

• 自定义标记

• (字段、超链接、运行) 运行级别内容

[示例：考虑具有单个段落的基本 WordprocessingML 文档。 此段落将按以下方式表示：

<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>  

p 元素是段落中所有内容的容器，在此示例中，该段落包含文本运行和简单字段。 示例结束]

父元素
body (§17.2.2) ;comment (§17.13.4.2) ;customXml (§17.5.1.6) ;docPartBody (§17.12.6) ;endnote (§17.11.2) ;脚注 (§17.11.10) ;ftr (§17.10.3) ;hdr (§17.10.4) ;sdtContent (§17.5.2.34) ;tc (§17.4.66)

子元素	第
bdo (双向重写)	§17.3.2.3
bookmarkEnd (Bookmark End)	§17.13.6.1
bookmarkStart (Bookmark Start)	§17.13.6.2
commentRangeEnd (注释定位点范围结束)	§17.13.4.3
commentRangeStart (注释定位点范围开始)	§17.13.4.4
customXml (内联级别自定义 XML 元素)	§17.5.1.3
customXmlDelRangeEnd (自定义 XML 标记删除结束)	§17.13.5.4
customXmlDelRangeStart (自定义 XML 标记删除开始)	§17.13.5.5
customXmlInsRangeEnd (自定义 XML 标记插入结束)	§17.13.5.6
customXmlInsRangeStart (自定义 XML 标记插入开始)	§17.13.5.7
customXmlMoveFromRangeEnd (自定义 XML 标记移动源端)	§17.13.5.8
customXmlMoveFromRangeStart (自定义 XML 标记移动源启动)	§17.13.5.9
customXmlMoveToRangeEnd (自定义 XML 标记移动目标位置结束)	§17.13.5.10
customXmlMoveToRangeStart (自定义 XML 标记移动目标位置开始)	§17.13.5.11
del (Deleted Run Content)	§17.13.5.14
dir (双向嵌入级别)	§17.3.2.8
fldSimple (简单字段)	§17.16.19
超链接 (超链接)	§17.16.22
ins (Inserted Run Content)	§17.13.5.18
moveFrom (移动源运行内容)	§17.13.5.22
moveFromRangeEnd (移动源位置容器 - 结束)	§17.13.5.23
moveFromRangeStart (移动源位置容器 - 启动)	§17.13.5.24
moveTo (移动目标运行内容)	§17.13.5.25
moveToRangeEnd (移动目标位置容器 - end)	§17.13.5.27
moveToRangeStart (移动目标位置容器 - 启动)	§17.13.5.28
oMath (Office 数学)	§22.1.2.77
oMathPara (Office 数学段落)	§22.1.2.78
permEnd (范围权限结束)	§17.13.7.1
permStart (Range 权限启动)	§17.13.7.2
pPr (Paragraph 属性)	§17.3.1.26
proofErr (校对错误定位点)	§17.13.8.1
r (文本运行)	§17.3.2.25
sdt (Inline-Level 结构化文档标记)	§17.5.2.31
smartTag (内联级别智能标记)	§17.5.1.9
subDoc (子文档位置的定位点)	§17.17.1.1

属性	说明
用于段落删除) 的 rsidDel (修订标识符	指定从main文档中删除段落时用于跟踪编辑会话的唯一标识符。 本文档中具有相同值的所有 rsid* 属性（如果存在）应指示这些区域在同一编辑会话期间进行了修改， (后续保存操作) 之间的时间。 创建者可以选择递增修订保存 ID 值以指示后续编辑会话，以指示修改相对于本文档中其他修改的顺序。 此属性的可能值由 ST_LongHexNumber 简单类型 (§17.18.50) 定义。
段落属性) 的 rsidP (修订标识符	此属性指定一个唯一标识符，用于跟踪编辑会话时，该段落的属性上次修改在此文档中。 本文档中具有相同值的所有 rsid* 属性（如果存在）应指示这些区域在同一编辑会话期间进行了修改， (后续保存操作) 之间的时间。 创建者可以选择递增修订保存 ID 值以指示后续编辑会话，以指示修改相对于本文档中其他修改的顺序。 此属性的可能值由 ST_LongHexNumber 简单类型 (§17.18.50) 定义。
段落) 的 rsidR (修订标识符	此属性指定在将段落添加到main文档时用于跟踪编辑会话的唯一标识符。 本文档中具有相同值的所有 rsid* 属性（如果存在）应指示这些区域在同一编辑会话期间进行了修改， (后续保存操作) 之间的时间。 创建者可以选择递增修订保存 ID 值以指示后续编辑会话，以指示修改相对于本文档中其他修改的顺序。 此属性的可能值由 ST_LongHexNumber 简单类型 (§17.18.50) 定义。
rsidRDefault (运行) 的默认修订标识符	此属性指定用于此段落中未显式声明 rsidR 属性的所有运行的唯一标识符。 此属性允许使用者优化本文档中写入 rsid* 值的位置。 本文档中具有相同值的所有 rsid* 属性（如果存在）应指示这些区域在同一编辑会话期间进行了修改， (后续保存操作) 之间的时间。 创建者可以选择递增修订保存 ID 值以指示后续编辑会话，以指示修改相对于本文档中其他修改的顺序。 此属性的可能值由 ST_LongHexNumber 简单类型 (§17.18.50) 定义。
段落字形格式设置) 的 rsidRPr (修订标识符	此属性指定在上次修改main文档中表示段落标记的字形字符时用于跟踪编辑会话的唯一标识符。 本文档中具有相同值的所有 rsid* 属性（如果存在）应指示这些区域在同一编辑会话期间进行了修改， (后续保存操作) 之间的时间。 创建者可以选择递增修订保存 ID 值以指示后续编辑会话，以指示修改相对于本文档中其他修改的顺序。 此属性的可能值由 ST_LongHexNumber 简单类型 (§17.18.50) 定义。

[注意：此元素的内容模型 (CT_P) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

ISO/IEC29500：2008。

构造函数

Paragraph()	初始化 Paragraph 类的新实例。
Paragraph(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 Paragraph 类的新实例。
Paragraph(OpenXmlElement[])	使用指定的子元素初始化 Paragraph 类的新实例。
Paragraph(String)	从外部 XML 初始化 Paragraph 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
NoSpellError	noSpellErr，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：w14：noSpellErr
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
ParagraphId	paraId，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：w14：paraId
ParagraphProperties	段落属性。 表示架构中的以下元素标记：w：pPr。
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
RsidParagraphAddition	段落的修订标识符 表示架构中的以下属性：w：rsidR
RsidParagraphDeletion	段落删除的修订标识符 表示架构中的以下属性：w：rsidDel
RsidParagraphMarkRevision	段落字形格式的修订标识符 表示架构中的以下属性：w：rsidRPr
RsidParagraphProperties	段落属性的修订标识符 表示架构中的以下属性：w：rsidP
RsidRunAdditionDefault	运行的默认修订标识符 表示架构中的以下属性：w：rsidRDefault
TextId	textId，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：w14：textId
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	定义 Paragraph 类。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 w：p。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)