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); концевая сноска (§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 (конец закладки)	§17.13.6.1
bookmarkStart (Начало закладки)	§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 (удаленное содержимое запуска)	§17.13.5.14
dir (двунаправленный уровень внедрения)	§17.3.2.8
fldSimple (простое поле)	§17.16.19
гиперссылка (гиперссылка)	§17.16.22
ins (вставленное содержимое запуска)	§17.13.5.18
moveFrom (Перемещение исходного содержимого запуска)	§17.13.5.22
moveFromRangeEnd (переместить контейнер расположения источника — end)	§17.13.5.23
moveFromRangeStart (Перемещение контейнера расположения источника — запуск)	§17.13.5.24
moveTo (Переместить содержимое целевого запуска)	§17.13.5.25
moveToRangeEnd (переместить контейнер расположения назначения — конец)	§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 (запуск разрешений диапазона)	§17.13.7.2
pPr (свойства абзаца)	§17.3.1.26
proofErr (привязка ошибки проверки правописания)	§17.13.8.1
r (текстовый запуск)	§17.3.2.25
sdt (встроенный структурированный тег документа)	§17.5.2.31
smartTag (встроенный смарт-тег)	§17.5.1.9
subDoc (привязка для расположения субдокумента)	§17.17.1.1

Атрибуты	Описание
rsidDel (идентификатор редакции для удаления абзаца)	Указывает уникальный идентификатор, используемый для отслеживания сеанса редактирования при удалении абзаца из документа main. Все атрибуты rsid* в этом документе с одинаковым значением, если они имеются, должны указывать на то, что эти регионы были изменены во время одного и того же сеанса редактирования (время между последующими действиями сохранения). Производитель может увеличить значение идентификатора сохранения редакции, чтобы указать последующие сеансы редактирования, чтобы указать порядок изменений по сравнению с другими изменениями в этом документе. Возможные значения для этого атрибута определяются простым типом ST_LongHexNumber (§17.18.50).
rsidP (идентификатор редакции для свойств абзаца)	Этот атрибут задает уникальный идентификатор, используемый для отслеживания сеанса редактирования, когда свойства абзаца были в последний раз изменены в этом документе. Все атрибуты rsid* в этом документе с одинаковым значением, если они имеются, должны указывать на то, что эти регионы были изменены во время одного и того же сеанса редактирования (время между последующими действиями сохранения). Производитель может увеличить значение идентификатора сохранения редакции, чтобы указать последующие сеансы редактирования, чтобы указать порядок изменений по сравнению с другими изменениями в этом документе. Возможные значения для этого атрибута определяются простым типом ST_LongHexNumber (§17.18.50).
rsidR (идентификатор редакции для абзаца)	Этот атрибут задает уникальный идентификатор, используемый для отслеживания сеанса редактирования при добавлении абзаца в документ main. Все атрибуты rsid* в этом документе с одинаковым значением, если они имеются, должны указывать на то, что эти регионы были изменены во время одного и того же сеанса редактирования (время между последующими действиями сохранения). Производитель может увеличить значение идентификатора сохранения редакции, чтобы указать последующие сеансы редактирования, чтобы указать порядок изменений по сравнению с другими изменениями в этом документе. Возможные значения для этого атрибута определяются простым типом ST_LongHexNumber (§17.18.50).
rsidRDefault (идентификатор редакции по умолчанию для выполнения)	Этот атрибут задает уникальный идентификатор, используемый для всех запусков в этом абзаце, которые явно не объявляют атрибут rsidR. Этот атрибут позволяет потребителям оптимизировать расположения, в которых в этом документе записаны значения rsid*. Все атрибуты rsid* в этом документе с одинаковым значением, если они имеются, должны указывать на то, что эти регионы были изменены во время одного и того же сеанса редактирования (время между последующими действиями сохранения). Производитель может увеличить значение идентификатора сохранения редакции, чтобы указать последующие сеансы редактирования, чтобы указать порядок изменений по сравнению с другими изменениями в этом документе. Возможные значения для этого атрибута определяются простым типом ST_LongHexNumber (§17.18.50).
rsidRPr (идентификатор редакции для форматирования глифа абзаца)	Этот атрибут задает уникальный идентификатор, используемый для отслеживания сеанса редактирования при последнем изменении символа глифа, представляющего знак абзаца, в документе main. Все атрибуты rsid* в этом документе с одинаковым значением, если они имеются, должны указывать на то, что эти регионы были изменены во время одного и того же сеанса редактирования (время между последующими действиями сохранения). Производитель может увеличить значение идентификатора сохранения редакции, чтобы указать последующие сеансы редактирования, чтобы указать порядок изменений по сравнению с другими изменениями в этом документе. Возможные значения для этого атрибута определяются простым типом ST_LongHexNumber (§17.18.50).

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_P) находится в §A.1. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

Paragraph()	Инициализирует новый экземпляр класса Paragraph.
Paragraph(IEnumerable<OpenXmlElement>)	Инициализирует новый экземпляр класса Paragraph указанными дочерними элементами.
Paragraph(OpenXmlElement[])	Инициализирует новый экземпляр класса Paragraph указанными дочерними элементами.
Paragraph(String)	Инициализирует новый экземпляр класса Paragraph из внешнего XML-кода.

Свойства

ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от 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)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от 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. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от 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)