Insert and Append Files
گاهی اوقات لازم است چندین سند را به یک ترکیب کنید. شما می توانید این کار را به صورت دستی انجام دهید یا می توانید از آن استفاده کنید. Aspose.Words وارد کردن یا قابلیت append
عملیات ورودی به شما اجازه می دهد تا محتوای اسناد قبلا ایجاد شده را به یک جدید یا موجود وارد کنید.
به نوبه خود، ویژگی Append به شما اجازه می دهد تا یک سند را فقط در پایان یک سند دیگر اضافه کنید.
این مقاله توضیح می دهد که چگونه یک سند را به روش های مختلف به یکدیگر وارد کنید و ویژگی های مشترکی را که می توانید در هنگام قرار دادن یا ارسال اسناد درخواست دهید، توصیف کنید.
اضافه کردن یک سند
همانطور که در بالا ذکر شد، در Aspose.Words یک سند به عنوان یک درخت گره ها نشان داده می شود و عملکرد قرار دادن یک سند به یک دیگر، کپی کردن گره ها از درخت سند اول به درخت دوم است.
شما می توانید اسناد را به روش های مختلف وارد کنید. به عنوان مثال، شما می توانید یک سند را از طریق یک عملیات جایگزین، یک میدان ادغام در طول یک عملیات ادغام شده یا از طریق یک نشانه وارد کنید.
شما همچنین می توانید از InsertDocument یا InsertDocumentInline روش، که شبیه به قرار دادن یک سند در Microsoft Word, برای قرار دادن یک سند کامل در موقعیت مکانی فعلی بدون واردات قبلی.
مثال کد زیر نشان می دهد که چگونه یک سند را با استفاده از InsertDocument روش:
مثال کد زیر نشان می دهد که چگونه یک سند را با استفاده از InsertDocumentInline روش:
زیربخش ها گزینه هایی را توصیف می کنند که در آن می توانید یک سند را به یک دیگر وارد کنید.
یک سند را در طول عملیات پیدا و جایگزین کنید
شما می توانید اسناد را هنگام انجام عملیات پیدا و جایگزین کنید. به عنوان مثال، یک سند می تواند حاوی پاراگراف هایی با متن (INTRODUCTION) و [CONUSION] باشد. اما در سند نهایی، شما باید این پاراگراف ها را با محتوایی که از یک سند خارجی دیگر به دست آمده جایگزین کنید. برای رسیدن به آن، شما باید یک کارگزار برای جایگزینی رویداد ایجاد کنید.
مثال کد زیر نشان می دهد که چگونه برای ایجاد یک مسئول برای جایگزینی رویداد برای استفاده بعد از آن در فرآیند قرار دادن:
مثال کد زیر نشان می دهد که چگونه محتوای یک سند را در یک عمل پیدا و جایگزین به دیگری وارد کنید:
اضافه کردن یک سند در طول Mail Merge عملیات
شما می توانید یک سند را در یک زمینه ادغام شده در طول یک mail merge عملیات برای مثال، mail merge قالب می تواند شامل یک میدان ادغام مانند [Summary] باشد. اما در سند نهایی، شما باید محتوای به دست آمده از یک سند خارجی دیگر را در این زمینه ادغام کنید. برای رسیدن به این هدف، شما باید یک کارگزار برای رویداد ادغام ایجاد کنید.
مثال کد زیر نشان می دهد که چگونه برای ایجاد یک مسئول برای ادغام رویداد برای استفاده بعد از آن در فرآیند قرار دادن:
مثال کد زیر نشان می دهد که چگونه یک سند را در زمینه ادغام با استفاده از کارگزار ایجاد شده وارد کنید:
اضافه کردن یک سند در Bookmark
شما می توانید یک فایل متنی را به یک سند وارد کنید و بلافاصله پس از یک نشانه که در سند تعریف کرده اید، آن را وارد کنید. برای انجام این کار، یک پاراگراف مشخص ایجاد کنید که می خواهید سند وارد شود.
مثال زیر نشان می دهد که چگونه محتوای یک سند را به یک نشانه در یک سند دیگر وارد کنید:
Append a Document
شما ممکن است یک مورد استفاده داشته باشید که در آن شما باید صفحات اضافی را از یک سند به انتهای یک سند موجود اضافه کنید. برای انجام این کار، شما فقط باید تماس بگیرید AppendDocument روش اضافه کردن یک سند به انتهای یک دیگر
مثال کد زیر نشان می دهد که چگونه یک سند را به انتهای یک سند دیگر ارسال کنیم:
واردات و Insert Nodes Manual
Aspose.Words به شما اجازه می دهد تا اسناد را به طور خودکار بدون هیچ گونه الزامات واردات قبلی وارد و ارسال کنید. با این حال، اگر شما باید یک گره خاص از سند خود، مانند یک بخش یا یک پاراگراف را وارد کنید، ابتدا باید این گره را به صورت دستی وارد کنید.
هنگامی که شما نیاز به قرار دادن یا قرار دادن یک بخش یا پاراگراف به بخش دیگر دارید، اساسا باید گره های درخت گره اول را با استفاده از لایه دوم وارد کنید. ImportNode روش پس از وارد کردن گره ها، باید از آن استفاده کنید. InsertAfter روش برای قرار دادن یک گره جدید پس از / قبل از گره مرجع. این اجازه می دهد تا شما را به سفارشی سازی فرایند ورود با واردات گره ها از یک سند و قرار دادن آن در موقعیت های معین.
شما همچنین می توانید از AppendChild روش اضافه کردن یک گره مشخص جدید به انتهای لیست گره های کودک، به عنوان مثال، اگر می خواهید به جای سطح بخش، محتوای را در سطح پاراگراف قرار دهید.
مثال کد زیر نشان می دهد که چگونه گره های وارد دستی را وارد کنید و آنها را پس از یک گره خاص با استفاده از گره خاص قرار دهید. InsertAfter روش:
محتوا به بخش سند مقصد توسط بخش وارد می شود، به این معنی که تنظیمات، مانند تنظیمات صفحه و هدر یا پا، در طول واردات حفظ می شوند. همچنین مفید است که توجه داشته باشید که شما می توانید تنظیمات قالب بندی را زمانی که یک سند را وارد می کنید یا ارسال می کنید، تعریف کنید تا مشخص کنید که چگونه دو سند به هم پیوسته اند.
ویژگی های مشترک برای Insert و Append Files
هر دو InsertDocument و AppendDocument روش های پذیرش ImportFormatMode و ImportFormatOptions به عنوان پارامترهای ورودی The The The The The The ImportFormatMode اجازه می دهد تا شما را به کنترل چگونه قالب بندی سند ادغام زمانی که شما واردات محتوا از یک سند به یک دیگر با انتخاب حالت های مختلف فرمت مانند مانند انتخاب حالت های مختلف فرمت مانند UseDestinationStyles, KeepSourceFormatting, و KeepDifferentStyles… The The The The The The ImportFormatOptions اجازه می دهد گزینه های مختلف واردات مانند IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, و SmartStyleBehavior…
Aspose.Words به شما اجازه می دهد تا تجسم یک سند نتیجه را تنظیم کنید زمانی که دو سند با هم در یک عملیات ورودی یا Append با استفاده از آن اضافه می شوند. Section و PageSetup خواص The The The The The The PageSetup مالکیت شامل تمام ویژگی های یک بخش مانند SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, و دیگران. رایج ترین مورد استفاده این است که تنظیم کنید SectionStart ملک برای تعریف اینکه آیا محتوای اضافه شده در یک صفحه ظاهر می شود یا به یک صفحه جدید تقسیم می شود.
مثال کد زیر نشان می دهد که چگونه یک سند را به یک دیگر اضافه کنید در حالی که محتوا را از دو صفحه جدا نگه دارید: