Revisions
Revisions
מדריך זה מציג כיצד לבדוק, לקבל, לדחות ולתעד שינויים במעקב במסמך Word עם Aspose.Words FOSS עבור .NET. Aspose.Words FOSS עבור .NET יכול לבדוק, לקבל ולדחות שינויים במעקב (תיקונים) במסמך Word דרך Document.Revisions, ויכול לתעד שינויים חדשים במעקב במהלך העריכה באמצעות Document.StartTrackRevisions()/StopTrackRevisions().
קריאת שינויים במעקב
Document.Revisions מחזיר RevisionCollection של כל Revision במסמך; Range.Revisions מצמצם את אותו לתחום ספציפי. כל Revision מדווח מי ביצע את השינוי ומתי (Author, DateTime), איזה סוג שינוי זה (RevisionType: Insertion, Deletion, FormatChange, StyleDefinitionChange, או Moving), ולאן הוא חל (ParentNode, ParentStyle). Document.HasRevisions מודיע לך מראש אם למסמך שנטען יש שינויים במעקב כלל.
קבלה ודחיית תיקונים
הפעל את Revision.Accept() או Revision.Reject() כדי לפתור שינוי במעקב בודד, או לעבוד על כל האוסף בבת אחת עם RevisionCollection.AcceptAll() / RejectAll(). Document.AcceptAllRevisions() הוא נוחות ברמת המסמך שמקבל כל תיקון בקריאה אחת. כדי לקבל או לדחות תת-קבוצה באופן סלקטיבי, מימוש IRevisionCriteria.IsMatch(revision) והעבר אותו ל-RevisionCollection.Accept(criteria) או ל-Reject(criteria).
קבוצות תיקונים
גרסאות רצופות מאותו מחבר ובאותו סוג מוצגות יחד כ-RevisionGroup — נגישות דרך Revision.Group לגרסה יחידה, או RevisionCollection.Groups (RevisionGroupCollection) עבור כל קבוצה במסמך. כל קבוצה מדווחת את ה-Text, ה-Author וה-RevisionType המשולבים שלה.
תיעוד שינויים במעקב חדשים
הפעל את Document.StartTrackRevisions(author) או את העומס StartTrackRevisions(author, dateTime) לפני ביצוע עריכות כך שהשינויים הבאים יירשמו כגרסאות במקום שיוחלו ישירות; הפעל את StopTrackRevisions() כדי לסיים את המעקב. המאפיין Document.TrackRevisions משקף האם המעקב פעיל כרגע.
צפייה בתוכן המקורי מול הסופי
Document.RevisionsView קובע האם המסמך מוצג במצב Original או Final (ערך RevisionsView) כאשר קיימות גרסאות, מבלי לשנות את נתוני הגרסה הבסיסיים.
טיפים ושיטות עבודה מומלצות
- בדוק את
Document.HasRevisionsלפני איטרציה עלDocument.Revisionsכדי לדלג על עבודה מיותרת במסמכים ללא שינויים במעקב. - העדף את
RevisionCollection.Accept(criteria)/Reject(criteria)עםIRevisionCriteriaמותאם אישית על פני סינון ידני והפעלתRevision.Accept()אחת אחרי השנייה. RevisionGroupשימושי להצגת סיכום קריא של השינויים — קיבוץ גרסאות רצופות מאותו מחבר, מאותו סוג מונע טיפול בכל תו שהוכנס כפריט נפרד.- תמיד צמד את
StartTrackRevisions()עם קריאתStopTrackRevisions()מאוחרת יותר כדי שמעריכות שאינן קשורות לא יירשמו כשינויים במעקב.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
Document.Revisions ריק לאחר עריכות | StartTrackRevisions() לא נקרא אף פעם לפני עריכה | קרא ל-StartTrackRevisions(author) לפני ביצוע עריכות שברצונך לעקוב אחריהן |
RevisionCollection.Accept(criteria) אינו מקבל דבר | IRevisionCriteria.IsMatch() לא תואם לאף גרסה | אמת את הלוגיקה של הקריטריונים מול ערכי Revision.Author/RevisionType/ParentNode בפועל תחילה |
המסמך עדיין מציג סימון של שינוי במעקב אחרי AcceptAllRevisions() | הצג מצב, לא נתוני גרסה | הגדר את Document.RevisionsView ל-Final אם אתה צריך את תצוגת התוכן הפתרון |
FAQ
איך אני בודק אם למסמך יש שינויים במעקב?
קרא את Document.HasRevisions — זה true אם Document.Revisions מכיל לפחות Revision אחד.
מה ההבדל בין Revision.Accept() ל-RevisionCollection.AcceptAll()?
Revision.Accept() פותר גרסה ספציפית אחת; RevisionCollection.AcceptAll() (או Document.AcceptAllRevisions()) פותרות את כל הגרסאות באוסף בבת אחת.
איך אני מקבל רק תיקונים שנעשו על ידי מחבר ספציפי?
מיישם IRevisionCriteria.IsMatch(revision) כדי לבדוק את revision.Author, ואז קורא ל-RevisionCollection.Accept(criteria) עם המימוש הזה.
איך אני מתעד את העריכות שלי כתיקוני מעקב?
קרא ל-Document.StartTrackRevisions(author) לפני ביצוע העריכות, ואז Document.StopTrackRevisions() כשסיימת.
אילו סוגי תיקונים קיימים?
RevisionType מגדיר את Insertion, Deletion, FormatChange, StyleDefinitionChange ו-Moving.
API Reference סיכום
| מחלקה / שיטה | תיאור |
|---|---|
Document.Revisions | RevisionCollection של כל השינויים במעקב במסמך |
Revision | שינוי אחד במעקב: Author, DateTime, RevisionType, Accept(), Reject() |
RevisionCollection | AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria), Groups |
RevisionGroup / RevisionGroupCollection | גרסאות רצופות של אותו מחבר, אותו סוג, מקובצות יחד |
IRevisionCriteria | פונקציית חיזוי מותאמת אישית (IsMatch(revision)) לקבלה/דחייה סלקטיבית |
Document.StartTrackRevisions() / StopTrackRevisions() | תעד עריכות חדשות כשינויים במעקב |
Document.RevisionsView | הצגת תוכן מתוקן של Original או Final |
