向Word添加一段文本

文档层次结构 [段落之后] 是一段连续文本，它定义具有一组常见属性的文本区域。一段连续文本由 r 元素表示，这样创建器便可组合换行、样式或格式设置属性，从而将相同信息应用于一段连续文本的所有部分。

正如段落可具有属性一样，一段连续文本也可具有属性。r 元素中的所有元素的属性由相应的可选 rPr 连续文本属性元素控制，这些元素必须是 r 元素的第一个子级。反过来说，rPr 元素是应用于 r 元素的其余子级的一组属性元素的容器。例如，通过 rPr 容器元素中的元素，使用者可控制以下 t 元素中的文本是否为加粗、带下划线或可见格式。连续文本属性的一些示例包括粗体、边框、字符样式、颜色、字体、字号、斜体、字距调整、禁用拼写/语法检查、底纹、小号大写字母、删除线、文字方向和下划线。

 

下表列出使用一段连续文本时使用的最常见 Open XML SDK 类。

XML 元素	Open XML SDK 2.0 类
p	Paragraph
rPr	RunProperties
t	Text

Run Class

Open XML SDK 2.5 Run 类代 表连续文本 (<r** )，该元素在 WordprocessingML 文档的 Open XML 文件格式架构中定义，如上所述。** > 使用 Run 对象处理 WordprocessingML 文档中的个别 <r> 元素。

RunProperties 类

WordprocessingML 中, 使用 run 属性 (<rPr>) 元素指定 run 元素的属性 。 连续文本属性的一些示例包括粗体、边框、字符样式、颜色、字体、字号、斜体、字距调整、禁用拼写/语法检查、底纹、小号大写字母、删除线、文字方向和下划线。 使用 RunProperties 对象可以设置 WordprocessingML 文档中一段连续文本的属性。

Text 对象

对于 <r> 元素，text (<t>) 元素是组成文档内容的文本的容器。 ** OXML SDK Text 类** 表示 <t> 元素。 使用 Text 对象可以在字处理文档中放置文本。

代码示例

以下代码可将文本添加到指定 Word 文档的主文档图面。 Run 对象可区分段落中的文本区域，然后 RunProperties 对象用于对一段连续文本应用粗体格式。

    public static void WriteToWordDoc(string filepath, string txt)
    {
        // Open a WordprocessingDocument for editing using the filepath.
        using (WordprocessingDocument wordprocessingDocument =
             WordprocessingDocument.Open(filepath, true))
        {
            // Assign a reference to the existing document body.
            Body body = wordprocessingDocument.MainDocumentPart.Document.Body;

            // Add new text.
            Paragraph para = body.AppendChild(new Paragraph());
            Run run = para.AppendChild(new Run());

            // Apply bold formatting to the run.
            RunProperties runProperties = run.AppendChild(new RunProperties(new Bold()));   
            run.AppendChild(new Text(txt));                
        }
    }