ドキュメントのクローンを作成する

ドキュメントのクローン作成は、元のドキュメントの同一のコピーを作成するプロセスです。これにより、パフォーマンスが向上し、潜在的なメモリリークを防ぐことができます。

この記事では、ドキュメントのクローン作成の主な使用例と、Aspose.Words を使用してドキュメントのクローンを作成する方法について説明します。

クローンドキュメントの操作

クローン操作を使用すると、毎回ファイルからドキュメントをロードして解析する必要がなくなるため、ドキュメントの作成プロセスを高速化できます。

ドキュメントのクローンを作成した後、それを編集して、元のドキュメントと比較したり、別のドキュメントに追加または挿入したりするなど、さまざまな操作を実行できるようになります。クローン要素またはそのコンテンツを別のドキュメントに挿入する前に変更することもできます。

ドキュメントクローンの作成

Aspose.Words では、ドキュメントのディープコピーを実行してそれを返す clone メソッドを使用してドキュメントのクローンを作成できます。つまり、DOM の完全なコピーを取得します。 clone メソッドを使用するとドキュメントの生成が高速化され、ドキュメントのコピーを取得するために必要なコードは 1 行だけです。

クローンを作成すると、元のドキュメントと同じ内容を持つ新しいドキュメントが作成されますが、元のドキュメントの各ノードの一意のコピーが含まれます。ノード clone メソッドを使用してクローン操作をドキュメントノードに適用することもできます。これにより、子ノードの有無にかかわらず複合ドキュメントノードを複製できます。

クローン作成メソッドを適用すると、すべてのドキュメントプロパティがクローンされることに注意してください。

次のコード例は、ドキュメントのクローンを作成し、そのドキュメント内のセクションの複製を作成する方法を示しています。

# Create a document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("This is the original document before applying the clone method")

# Clone the document.
clone = doc.clone().as_document()

# Edit the cloned document.
builder = aw.DocumentBuilder(clone)
builder.write("Section 1")
builder.insert_break(aw.BreakType.SECTION_BREAK_NEW_PAGE)
builder.write("Section 2")

# This shows what is in the document originally. The document has two sections.
self.assertEqual(clone.sections.count, 2)

# Duplicate the last section and append the copy to the end of the document.
lastSectionIdx = clone.sections.count - 1
newSection = clone.sections[lastSectionIdx].clone()
clone.sections.add(newSection)

# Check what the document contains after we changed it.
self.assertEqual(clone.sections.count, 3)

Python でドキュメントを比較するドキュメントの挿入と追加