הכנס וצרף מסמכים
לפעמים זה נדרש לשלב כמה מסמכים לתוך אחד. אתה יכול לעשות זאת באופן ידני או שאתה יכול להשתמש בתכונה Aspose.Words הוספה או צירוף.
פעולת ההוספה מאפשרת לך להכניס את התוכן של מסמכים שנוצרו בעבר למסמך חדש או קיים.
בתורו, התכונה ‘הוסף’ מאפשרת לך להוסיף מסמך רק בסוף מסמך אחר.
מאמר זה מסביר כיצד להוסיף או לצרף מסמך למסמך אחר בדרכים שונות ומתאר את המאפיינים הנפוצים שניתן להחיל בעת הוספה או צירוף מסמכים.
הכנס מסמך
כאמור לעיל, ב Aspose.Words מסמך מיוצג כעץ צמתים, והפעולה של הכנסת מסמך אחד למשנהו היא העתקת צמתים מעץ המסמך הראשון לשני.
ניתן להוסיף מסמכים במגוון מיקומים בדרכים שונות. לדוגמה, ניתן להוסיף מסמך באמצעות פעולת החלפה, שדה מיזוג במהלך פעולת מיזוג או באמצעות סימניה.
ניתן גם להשתמש בשיטת InsertDocument, הדומה להכנסת מסמך ב Microsoft Word, כדי להוסיף מסמך שלם במיקום הסמן הנוכחי ללא ייבוא קודם.
דוגמת הקוד הבאה מראה כיצד להוסיף מסמך בשיטת InsertDocument:
סעיפי המשנה הבאים מתארים את האפשרויות שבמהלכן ניתן להכניס מסמך אחד למסמך אחר.
הכנס מסמך במהלך פעולת חיפוש והחלפה
ניתן להוסיף מסמכים בעת ביצוע פעולות חיפוש והחלפה. לדוגמה, מסמך יכול להכיל פסקאות עם הטקסט [INTRODUCTION] ו - [CONCLUSION]. אך במסמך הסופי, עליך להחליף את הפסקאות הללו בתוכן המתקבל ממסמך חיצוני אחר. כדי להשיג זאת, יהיה עליך ליצור מטפל לאירוע החלף.
דוגמת הקוד הבאה מראה כיצד ליצור מטפל לאירוע המחליף כדי להשתמש בו מאוחר יותר בתהליך ההכנסה:
דוגמת הקוד הבאה מראה כיצד הכנס תוכן של מסמך אחד למסמך אחר במהלך פעולת חיפוש והחלפה:
הכנס מסמך במהלך פעולת Mail Merge
ניתן להוסיף מסמך לשדה מיזוג במהלך פעולת Mail Merge. לדוגמה, תבנית Mail Merge יכולה להכיל שדה מיזוג כגון [סיכום]. אך במסמך הסופי, עליך להוסיף תוכן המתקבל ממסמך חיצוני אחר לשדה מיזוג זה. כדי להשיג זאת, יהיה עליך ליצור מטפל לאירוע המיזוג.
דוגמת הקוד הבאה מראה כיצד ליצור מטפל לאירוע המיזוג כדי להשתמש בו מאוחר יותר בתהליך ההכנסה:
דוגמת הקוד הבאה מראה כיצד להכניס מסמך לשדה המיזוג באמצעות המטפל שנוצר:
הכנס מסמך לסימנייה
ניתן לייבא קובץ טקסט למסמך ולהכניס אותו מיד לאחר סימניה שהגדרת במסמך. לשם כך, צור פסקה בסימניה שבה ברצונך להכניס את המסמך.
דוגמת הקידוד הבאה מראה כיצד להכניס את התוכן של מסמך אחד לסימניה במסמך אחר:
הוסף מסמך
ייתכן שיש לך מקרה שימוש שבו עליך לכלול דפים נוספים ממסמך ועד לסוף מסמך קיים. לשם כך, עליך רק להתקשר לשיטת AppendDocument כדי להוסיף מסמך לסוף מסמך אחר.
דוגמת הקוד הבאה מראה כיצד להוסיף מסמך לסוף מסמך אחר:
ייבוא והוספת צמתים ידנית
Aspose.Words מאפשר לך להוסיף ולצרף מסמכים באופן אוטומטי ללא כל דרישות יבוא קודמות. עם זאת, אם עליך להוסיף או לצרף צומת ספציפי של המסמך שלך, כגון קטע או פסקה, תחילה עליך לייבא צומת זה באופן ידני.
כאשר אתה צריך להוסיף או לצרף קטע או פסקה אחת לאחרת, אתה בעצם צריך לייבא את הצמתים של עץ צומת המסמך הראשון לשני בשיטה ImportNode. לאחר ייבוא הצמתים שלך, עליך להשתמש בשיטת InsertAfter / InsertBefore כדי להוסיף צומת חדש אחרי / לפני צומת הייחוס. זה מאפשר לך להתאים אישית את תהליך ההכנסה על ידי ייבוא צמתים ממסמך והכנסתו במיקומים נתונים.
ניתן גם להשתמש בשיטת AppendChild כדי להוסיף צומת חדש שצוין לסוף רשימת הצמתים של הילד, לדוגמה, אם ברצונך להוסיף תוכן ברמת הפסקה במקום ברמת הקטע.
דוגמת הקוד הבאה מראה כיצד לייבא ידנית צמתים ולהכניס אותם אחרי צומת ספציפי בשיטת InsertAfter:
תוכן מיובא למסמך היעד קטע אחר קטע, כלומר הגדרות, כגון הגדרת עמוד וכותרות עליונות או תחתונות, נשמרות במהלך הייבוא. כדאי גם לציין שניתן להגדיר הגדרות עיצוב בעת הוספה או צירוף של מסמך כדי לציין כיצד שני מסמכים מחוברים זה לזה.
מאפיינים נפוצים עבור הוספה וצירוף מסמכים
שניהם InsertDocument ו AppendDocument שיטות לקבל ImportFormatMode ו ImportFormatOptions כפרמטרים קלט. ה ImportFormatMode מאפשר לך לשלוט באופן מיזוג עיצוב המסמך בעת ייבוא תוכן ממסמך אחד למשנהו על ידי בחירת מצבי פורמט שונים כגון UseDestinationStyles, KeepSourceFormatting ו KeepDifferentStyles. ImportFormatOptions מאפשר לך לבחור אפשרויות ייבוא שונות כגון IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, ו SmartStyleBehavior.
Aspose.Words מאפשר לך להתאים את ההדמיה של מסמך שהתקבל כאשר שני מסמכים מתווספים יחד בפעולה הוספה או הוספה באמצעות המאפיינים Section ו PageSetup. המאפיין PageSetup מכיל את כל התכונות של קטע כגון SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, ואחרים. מקרה השימוש הנפוץ ביותר הוא להגדיר את המאפיין SectionStart כדי להגדיר אם התוכן שנוסף יופיע באותו דף או יתפצל לתוכן חדש.
דוגמת הקוד הבאה מראה כיצד לצרף מסמך אחד למשנהו תוך שמירה על פיצול התוכן לשני עמודים: