درج و الحاق اسناد

گاهی اوقات لازم است چندین سند را در یک سند ترکیب کنید. می توانید این کار را به صورت دستی انجام دهید یا می توانید از ویژگی درج یا ضمیمه Aspose.Words استفاده کنید.

عملیات درج به شما امکان می دهد محتوای اسناد ایجاد شده قبلی را در اسناد جدید یا موجود درج کنید.

به نوبه خود، ویژگی الحاق به شما امکان می دهد یک سند را فقط در انتهای یک سند دیگر اضافه کنید.

این مقاله نحوه درج یا الحاق یک سند به سند دیگر را به روش‌های مختلف توضیح می‌دهد و ویژگی‌های رایجی را که می‌توانید هنگام درج یا الحاق اسناد اعمال کنید، توضیح می‌دهد.

یک سند {#insert-a-document} را وارد کنید

همانطور که در بالا ذکر شد، در Aspose.Words یک سند به صورت درختی از گره ها نشان داده می شود و عملیات درج یک سند در سند دیگر، کپی کردن گره ها از درخت سند اول به دومین درخت است.

شما می توانید اسناد را در مکان های مختلف به روش های مختلف وارد کنید. به عنوان مثال، می توانید یک سند را از طریق عملیات جایگزینی، یک فیلد ادغام در طول عملیات ادغام یا از طریق یک نشانک وارد کنید.

همچنین می‌توانید از روش InsertDocument یا InsertDocumentInline، که شبیه درج یک سند در Microsoft Word است، برای درج یک سند کامل در موقعیت مکان‌نمای فعلی بدون وارد کردن قبلی استفاده کنید.

مثال کد زیر نحوه درج یک سند با استفاده از روش InsertDocument را نشان می دهد:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+Document srcDoc = new Document(MyDir + "Document source.docx");
+Document dstDoc = new Document(MyDir + "Northwind traders.docx");
+DocumentBuilder builder = new DocumentBuilder(dstDoc);
+builder.MoveToDocumentEnd();
+builder.InsertBreak(BreakType.PageBreak);
+builder.InsertDocument(srcDoc, ImportFormatMode.KeepSourceFormatting);
+builder.Document.Save(ArtifactsDir + "JoinAndAppendDocuments.InsertDocument.docx");

view raw insert-document-with-builder.cs hosted with ❤ by GitHub

مثال کد زیر نحوه درج یک سند با استفاده از روش InsertDocumentInline را نشان می دهد:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+DocumentBuilder srcDoc = new DocumentBuilder();
+srcDoc.Write("[src content]");
+// Create destination document.
+DocumentBuilder dstDoc = new DocumentBuilder();
+dstDoc.Write("Before ");
+dstDoc.InsertNode(new BookmarkStart(dstDoc.Document, "src_place"));
+dstDoc.InsertNode(new BookmarkEnd(dstDoc.Document, "src_place"));
+dstDoc.Write(" after");
+Assert.AreEqual("Before  after", dstDoc.Document.GetText().TrimEnd());
+// Insert source document into destination inline.
+dstDoc.MoveToBookmark("src_place");
+dstDoc.InsertDocumentInline(srcDoc.Document, ImportFormatMode.UseDestinationStyles, new ImportFormatOptions());
+Assert.AreEqual("Before [src content] after", dstDoc.Document.GetText().TrimEnd());

view raw insert-document-inline-with-builder.cs hosted with ❤ by GitHub

بخش‌های فرعی زیر گزینه‌هایی را توضیح می‌دهند که طی آن می‌توانید یک سند را در سند دیگر وارد کنید.

در حین عملیات یافتن و جایگزینی {#insert-a-document-during-find-and-replace-operation} یک سند وارد کنید

هنگام انجام عملیات یافتن و جایگزینی می توانید اسناد را وارد کنید. به عنوان مثال، یک سند می تواند شامل پاراگراف هایی با متن [مقدمه] و [نتیجه گیری] باشد. اما در سند نهایی باید آن پاراگراف ها را با محتوای بدست آمده از یک سند خارجی دیگر جایگزین کنید. برای دستیابی به آن، باید یک هندلر برای رویداد جایگزین ایجاد کنید.

مثال کد زیر نحوه ایجاد یک کنترل کننده برای رویداد جایگزین را نشان می دهد تا بعداً از آن در فرآیند درج استفاده شود:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+private class InsertDocumentAtReplaceHandler : IReplacingCallback
+{
+    ReplaceAction IReplacingCallback.Replacing(ReplacingArgs args)
+    {
+        Document subDoc = new Document(MyDir + "Document insertion 2.docx");
+        // Insert a document after the paragraph, containing the match text.
+        Paragraph para = (Paragraph)args.MatchNode.ParentNode;
+        InsertDocument(para, subDoc);
+        // Remove the paragraph with the match text.
+        para.Remove();
+        return ReplaceAction.Skip;
+    }
+}

view raw insert-document-at-replace-handler.cs hosted with ❤ by GitHub

مثال کد زیر نشان می دهد که چگونه محتوای یک سند را در طی عملیات Find and جایگزینی در سند دیگر وارد کنید:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+Document mainDoc = new Document(MyDir + "Document insertion 1.docx");
+FindReplaceOptions options = new FindReplaceOptions
+{
+    Direction = FindReplaceDirection.Backward,
+    ReplacingCallback = new InsertDocumentAtReplaceHandler()
+};
+mainDoc.Range.Replace(new Regex("\\[MY_DOCUMENT\\]"), "", options);
+mainDoc.Save(ArtifactsDir + "CloneAndCombineDocuments.InsertDocumentAtReplace.docx");

view raw insert-document-at-replace.cs hosted with ❤ by GitHub

در حین عملیات Mail Merge {#insert-a-document-during-mail-merge-operation} یک سند وارد کنید

شما می توانید یک سند را در یک فیلد ادغام در طول عملیات Mail Merge وارد کنید. برای مثال، یک الگوی Mail Merge می‌تواند شامل یک فیلد ادغام مانند [خلاصه] باشد. اما در سند نهایی، باید محتوای به دست آمده از یک سند خارجی دیگر را در این فیلد ادغام درج کنید. برای رسیدن به آن، باید یک کنترل کننده برای رویداد ادغام ایجاد کنید.

مثال کد زیر نحوه ایجاد یک کنترل کننده برای رویداد ادغام را نشان می دهد تا بعداً از آن در فرآیند درج استفاده شود:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+private class InsertDocumentAtMailMergeHandler : IFieldMergingCallback
+{
+    // This handler makes special processing for the "Document_1" field.
+    // The field value contains the path to load the document.
+    // We load the document and insert it into the current merge field.
+    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
+    {
+        if (args.DocumentFieldName == "Document_1")
+        {
+            // Use document builder to navigate to the merge field with the specified name.
+            DocumentBuilder builder = new DocumentBuilder(args.Document);
+            builder.MoveToMergeField(args.DocumentFieldName);
+            // The name of the document to load and insert is stored in the field value.
+            Document subDoc = new Document((string)args.FieldValue);
+            InsertDocument(builder.CurrentParagraph, subDoc);
+            // The paragraph that contained the merge field might be empty now, and you probably want to delete it.
+            if (!builder.CurrentParagraph.HasChildNodes)
+                builder.CurrentParagraph.Remove();
+            // Indicate to the mail merge engine that we have inserted what we wanted.
+            args.Text = null;
+        }
+    }
+    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
+    {
+        // Do nothing.
+    }
+}

view raw insert-document-at-mail-merge-handler.cs hosted with ❤ by GitHub

مثال کد زیر نحوه درج یک سند را در فیلد ادغام با استفاده از کنترل کننده ایجاد شده نشان می دهد:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+Document mainDoc = new Document(MyDir + "Document insertion 1.docx");
+mainDoc.MailMerge.FieldMergingCallback = new InsertDocumentAtMailMergeHandler();
+// The main document has a merge field in it called "Document_1".
+// The corresponding data for this field contains a fully qualified path to the document.
+// That should be inserted to this field.
+mainDoc.MailMerge.Execute(new[] { "Document_1" }, new object[] { MyDir + "Document insertion 2.docx" });
+mainDoc.Save(ArtifactsDir + "CloneAndCombineDocuments.InsertDocumentAtMailMerge.doc");

view raw insert-document-at-mail-merge.cs hosted with ❤ by GitHub

یک سند در نشانک {#insert-a-document-at-bookmark} وارد کنید

می توانید یک فایل متنی را در یک سند وارد کنید و آن را درست بعد از نشانکی که در سند تعریف کرده اید وارد کنید. برای انجام این کار، یک پاراگراف نشانه گذاری شده ایجاد کنید که می خواهید سند در آن درج شود.

مثال کدنویسی زیر نحوه درج محتوای یک سند را در یک نشانک در سند دیگر نشان می دهد:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+Document mainDoc = new Document(MyDir + "Document insertion 1.docx");
+Document subDoc = new Document(MyDir + "Document insertion 2.docx");
+Bookmark bookmark = mainDoc.Range.Bookmarks["insertionPlace"];
+InsertDocument(bookmark.BookmarkStart.ParentNode, subDoc);
+mainDoc.Save(ArtifactsDir + "CloneAndCombineDocuments.InsertDocumentAtBookmark.docx");

view raw insert-document-at-bookmark.cs hosted with ❤ by GitHub

توجه داشته باشید که نشانک نباید چندین پاراگراف یا متنی را که می‌خواهید در سند نهایی شما نمایش داده شود، در بر گیرد.

یک سند {#append-a-document} را اضافه کنید

ممکن است یک مورد استفاده داشته باشید که در آن باید صفحات اضافی را از یک سند تا انتهای یک سند موجود اضافه کنید. برای این کار، فقط باید روش AppendDocument را فراخوانی کنید تا یک سند به انتهای سند دیگر اضافه شود.

توجه داشته باشید که AppendChild یک روش سطح گره در یک سند است. برای مثال، می‌توانید یک پاراگراف ایجاد کنید، ویژگی‌های قالب‌بندی را تنظیم کنید، و سپس آن را به‌عنوان کودک با استفاده از روش AppendChild به بدنه اضافه کنید.

مثال کد زیر نحوه الحاق یک سند را به انتهای یک سند دیگر نشان می دهد:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
	Document dstDoc = new Document();
	dstDoc.FirstSection.Body.AppendParagraph("Destination document text. ");

	Document srcDoc = new Document();
	srcDoc.FirstSection.Body.AppendParagraph("Source document text. ");

	// Append the source document to the destination document.
	// Pass format mode to retain the original formatting of the source document when importing it.
	dstDoc.AppendDocument(srcDoc, ImportFormatMode.KeepSourceFormatting);

	dstDoc.Save(ArtifactsDir + "JoinAndAppendDocuments.KeepSourceFormatting.docx");

view raw keep-source-formatting.cs hosted with ❤ by GitHub

وارد کردن و درج گره ها به صورت دستی

Aspose.Words به شما امکان می دهد اسناد را به طور خودکار بدون نیاز به وارد کردن قبلی وارد و اضافه کنید. با این حال، اگر نیاز دارید که گره خاصی از سند خود را وارد یا اضافه کنید، مانند یک بخش یا یک پاراگراف، ابتدا باید این گره را به صورت دستی وارد کنید.

هنگامی که نیاز دارید یک بخش یا پاراگراف را به قسمت دیگر اضافه یا اضافه کنید، اساساً باید گره های درخت گره سند اول را با استفاده از روش ImportNode به دومی وارد کنید. پس از وارد کردن گره های خود، باید از روش InsertAfter/InsertBefore برای درج یک گره جدید بعد از/قبل از گره مرجع استفاده کنید. این به شما این امکان را می دهد که فرآیند درج را با وارد کردن گره ها از یک سند و درج آن در موقعیت های داده شده سفارشی کنید.

همچنین می توانید از روش AppendChild برای اضافه کردن یک گره مشخص شده جدید به انتهای لیست گره های فرزند استفاده کنید، به عنوان مثال، اگر می خواهید محتوا را به جای در سطح بخش، در سطح پاراگراف اضافه کنید.

مثال کد زیر نحوه وارد کردن دستی گره ها و درج آنها را بعد از یک گره خاص با استفاده از روش InsertAfter نشان می دهد:

+// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
+/// <summary>
+/// Inserts content of the external document after the specified node.
+/// Section breaks and section formatting of the inserted document are ignored.
+/// </summary>
+/// <param name="insertionDestination">Node in the destination document after which the content
+/// Should be inserted. This node should be a block level node (paragraph or table).</param>
+/// <param name="docToInsert">The document to insert.</param>
+private static void InsertDocument(Node insertionDestination, Document docToInsert)
+{
+    if (insertionDestination.NodeType == NodeType.Paragraph || insertionDestination.NodeType == NodeType.Table)
+    {
+        CompositeNode destinationParent = insertionDestination.ParentNode;
+        NodeImporter importer =
+            new NodeImporter(docToInsert, insertionDestination.Document, ImportFormatMode.KeepSourceFormatting);
+        // Loop through all block-level nodes in the section's body,
+        // then clone and insert every node that is not the last empty paragraph of a section.
+        foreach (Section srcSection in docToInsert.Sections.OfType<Section>())
+        foreach (Node srcNode in srcSection.Body)
+        {
+            if (srcNode.NodeType == NodeType.Paragraph)
+            {
+                Paragraph para = (Paragraph)srcNode;
+                if (para.IsEndOfSection && !para.HasChildNodes)
+                    continue;
+            }
+            Node newNode = importer.ImportNode(srcNode, true);
+            destinationParent.InsertAfter(newNode, insertionDestination);
+            insertionDestination = newNode;
+        }
+    }
+    else
+    {
+        throw new ArgumentException("The destination node should be either a paragraph or table.");
+    }
+}

view raw insert-document-as-nodes.cs hosted with ❤ by GitHub

وارد کردن یک گره جدید ایجاد می کند که یک کپی از گره اصلی است و برای درج در سند مقصد مناسب است.

محتوا بخش به بخش به سند مقصد وارد می شود، به این معنی که تنظیمات، مانند تنظیم صفحه و سرصفحه ها یا پاورقی ها، در حین واردات حفظ می شوند. توجه به این نکته نیز مفید است که می‌توانید تنظیمات قالب‌بندی را زمانی که سندی را وارد یا اضافه می‌کنید تعریف کنید تا مشخص کنید که چگونه دو سند به یکدیگر متصل می‌شوند.

ویژگی های رایج برای درج و الحاق اسناد

هر دو روش InsertDocument و AppendDocument ImportFormatMode و ImportFormatOptions را به عنوان پارامترهای ورودی می پذیرند. ImportFormatMode به شما امکان می دهد با انتخاب حالت های قالب بندی مختلف مانند UseDestinationStyles، KeepSourceFormatting، و KeepDifferentStyles، نحوه ادغام قالب بندی سند را هنگام وارد کردن محتوا از یک سند به سند دیگر کنترل کنید. ImportFormatOptions به شما امکان می دهد گزینه های مختلف واردات مانند IgnoreHeaderFooter، IgnoreTextBoxes، KeepSourceNumbering، MergePastedLists و SmartStyleBehavior را انتخاب کنید.

Aspose.Words به شما این امکان را می‌دهد که با استفاده از ویژگی‌های Section و PageSetup، تجسم یک سند حاصل را هنگامی که دو سند با هم در یک عملیات درج یا ضمیمه جمع می‌شوند، تنظیم کنید. ویژگی PageSetup شامل تمام ویژگی های یک بخش مانند SectionStart، RestartPageNumbering، PageStartingNumber، Orientation و غیره است. رایج ترین مورد استفاده، تنظیم ویژگی SectionStart برای تعیین اینکه آیا محتوای اضافه شده در همان صفحه ظاهر می شود یا به صفحه جدید تقسیم می شود، تنظیم می شود.

توجه داشته باشید که ویژگی‌های Section و PageSetup نحوه درج/الحاق دو سند را کنترل نمی‌کنند. آنها فقط به شما اجازه می دهند ظاهر سند نتیجه خود را تغییر دهید.

مثال کد زیر نشان می‌دهد که چگونه می‌توان یک سند را به سند دیگر اضافه کرد و در عین حال از تقسیم محتوا در دو صفحه جلوگیری کرد:

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
	Document srcDoc = new Document(MyDir + "Document source.docx");
	Document dstDoc = new Document(MyDir + "Northwind traders.docx");

	// Set the source document to continue straight after the end of the destination document.
	srcDoc.FirstSection.PageSetup.SectionStart = SectionStart.Continuous;

	// Restart the page numbering on the start of the source document.
	srcDoc.FirstSection.PageSetup.RestartPageNumbering = true;
	srcDoc.FirstSection.PageSetup.PageStartingNumber = 1;

	// To ensure this does not happen when the source document has different page setup settings, make sure the
	// settings are identical between the last section of the destination document.
	// If there are further continuous sections that follow on in the source document,
	// this will need to be repeated for those sections.
	srcDoc.FirstSection.PageSetup.PageWidth = dstDoc.LastSection.PageSetup.PageWidth;
	srcDoc.FirstSection.PageSetup.PageHeight = dstDoc.LastSection.PageSetup.PageHeight;
	srcDoc.FirstSection.PageSetup.Orientation = dstDoc.LastSection.PageSetup.Orientation;

	// Iterate through all sections in the source document.
	foreach (Paragraph para in srcDoc.GetChildNodes(NodeType.Paragraph, true))
	{
	para.ParagraphFormat.KeepWithNext = true;
	}

	dstDoc.AppendDocument(srcDoc, ImportFormatMode.KeepSourceFormatting);

	dstDoc.Save(ArtifactsDir + "JoinAndAppendDocuments.DifferentPageSetup.docx");

view raw different-page-setup.cs hosted with ❤ by GitHub

شبیه سازی یک سند در C# یک سند را در C# تقسیم کنید