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 1st Edition]

p (段落)

この要素は、ドキュメント内のコンテンツの段落を指定します。

WordprocessingML 文書の段落の内容は、次の 4 種類のコンテンツの任意の組み合わせで構成されます。

• Paragraph プロパティ

• 注釈 (ブックマーク、コメント、リビジョン)

• カスタム マークアップ

• 実行レベルのコンテンツ (フィールド、ハイパーリンク、実行)

[例: 1 つの段落を含む基本的な 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)

子要素	Subclause
bdo (双方向オーバーライド)	§17.3.2.3
bookmarkEnd (Bookmark End)	§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 (Simple Field)	§17.16.19
ハイパーリンク (ハイパーリンク)	§17.16.22
ins (挿入された実行コンテンツ)	§17.13.5.18
moveFrom (ソース実行コンテンツの移動)	§17.13.5.22
moveFromRangeEnd (Move Source Location Container - End)	§17.13.5.23
moveFromRangeStart (Move Source Location Container - Start)	§17.13.5.24
moveTo (移動先の実行コンテンツの移動)	§17.13.5.25
moveToRangeEnd (移動先の場所コンテナー - 終了)	§17.13.5.27
moveToRangeStart (移動先の場所コンテナー - 開始)	§17.13.5.28
oMath (Office Math)	§22.1.2.77
oMathPara (Office Math Paragraph)	§22.1.2.78
permEnd (範囲アクセス許可の終了)	§17.13.7.1
permStart (範囲アクセス許可の開始)	§17.13.7.2
pPr (段落プロパティ)	§17.3.1.26
proofErr (Proofing Error Anchor)	§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 (段落削除のリビジョン識別子)	段落がメインドキュメントから削除されたときに編集セッションを追跡するために使用される一意の識別子を指定します。 同じ値を持つこのドキュメント全体のすべての rsid* 属性 (存在する場合) は、それらのリージョンが同じ編集セッション中 (後続の保存アクション間) に変更されたことを示す必要があります。 プロデューサーは、リビジョンの保存 ID 値をインクリメントして、以降の編集セッションを示して、このドキュメントの他の変更に対する変更の順序を示すことができます。 この属性に使用できる値は、 ST_LongHexNumber 単純型 (§17.18.50) によって定義されます。
rsidP (段落プロパティのリビジョン識別子)	この属性は、このドキュメントで段落のプロパティが最後に変更されたときに編集セッションを追跡するために使用される一意の識別子を指定します。 同じ値を持つこのドキュメント全体のすべての rsid* 属性 (存在する場合) は、それらのリージョンが同じ編集セッション中 (後続の保存アクション間) に変更されたことを示す必要があります。 プロデューサーは、リビジョンの保存 ID 値をインクリメントして、以降の編集セッションを示して、このドキュメントの他の変更に対する変更の順序を示すことができます。 この属性に使用できる値は、 ST_LongHexNumber 単純型 (§17.18.50) によって定義されます。
rsidR (段落のリビジョン識別子)	この属性は、段落がメイン ドキュメントに追加されたときに編集セッションを追跡するために使用される一意の識別子を指定します。 同じ値を持つこのドキュメント全体のすべての rsid* 属性 (存在する場合) は、それらのリージョンが同じ編集セッション中 (後続の保存アクション間) に変更されたことを示す必要があります。 プロデューサーは、リビジョンの保存 ID 値をインクリメントして、以降の編集セッションを示して、このドキュメントの他の変更に対する変更の順序を示すことができます。 この属性に使用できる値は、 ST_LongHexNumber 単純型 (§17.18.50) によって定義されます。
rsidRDefault (実行の既定のリビジョン識別子)	この属性は、rsidR 属性を明示的に宣言しない、この段落のすべての実行に使用される一意の識別子を指定します。 この属性を使用すると、コンシューマーは、このドキュメントで rsid* 値が書き込まれる場所を最適化できます。 同じ値を持つこのドキュメント全体のすべての rsid* 属性 (存在する場合) は、それらのリージョンが同じ編集セッション中 (後続の保存アクション間) に変更されたことを示す必要があります。 プロデューサーは、リビジョンの保存 ID 値をインクリメントして、以降の編集セッションを示して、このドキュメントの他の変更に対する変更の順序を示すことができます。 この属性に使用できる値は、 ST_LongHexNumber 単純型 (§17.18.50) によって定義されます。
rsidRPr (段落グリフ書式設定のリビジョン識別子)	この属性は、段落マークを表すグリフ文字がメインドキュメントで最後に変更されたときに編集セッションを追跡するために使用される一意の識別子を指定します。 同じ値を持つこのドキュメント全体のすべての 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)	現在の要素の子要素の 1 つを別の 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)