מציג DOCX ב-ASP.NET Core: תצוגה מקדימה של קבצי Word

כדי להציג תצוגה מקדימה של מסמך Word בתוך יישום ASP.NET Core, השתמש ב‑SDK של מציג DOCX שמרנדר את הקובץ בשרת ומציג את העמודים שלו בדפדפן. Doconut מספקת את תהליך העבודה הזה ללא צורך ב‑Microsoft Word על השרת. המשתמשים שלך יכולים לקרוא חוזה, הצעה או דוח בתוך היישום במקום לפתוח תוכנה נפרדת במחשב.

השאלה המועילה היא מה קורה כשמחליפים את קובץ ההדגמה במסמכים שלכם. חוזה עשוי להכיל גופנים מותאמים, כותרות חוזרות, טבלאות רחבות ודפי חתימה. מדריך זה מציג את שלב פתיחת המסמך עבור יישום .NET 8 ואת הבדיקות שעוזרות להעריך את התוצאה.

פתיחת קובץ DOCX מ‑C#

התחל עם התחלה מהירה של Doconut .NET 8 כדי להגדיר את השירותים, מושב ASP.NET, middleware של המסמך, משאבי המציג, והווידג׳ט בדפדפן. הקצה של הקוד שלהלן מרחיב את היישום המוגדר; הוא אינו יישום עצמאי מלא.

מקם מסמך בדיקה לא רגיש ב‑App_Data/Sample.docx מתחת לשורש התוכן של היישום. הוסף את הקצה הזה לפני app.Run():

using Doconut;

app.MapPost("/api/preview-word", async (
    Viewer viewer,
    IWebHostEnvironment environment) =>
{
    var filePath = Path.Combine(
        environment.ContentRootPath, "App_Data", "Sample.docx");

    if (!File.Exists(filePath))
        return Results.NotFound();

    var token = await viewer.OpenDocumentAsync(filePath);
    return Results.Ok(new { token });
});

שמור על ההוראה using יחד עם שאר היבואיים בראש הקובץ Program.cs. הנתיב הקבוע מקל על שחזור הדוגמה ומונע קבלת נתיב שרת שרירותי מהדפדפן.

ה‑תיעוד API של Viewer מתעד את העומס של OpenDocumentAsync עם נתיב קובץ. הוא פותח את הקובץ ומחזיר אסימון מושב מסמך. בעמוד שבו ההתחלה המהירה כבר אתחלה את objViewer, פתח את התצוגה המקדימה עם:

async function previewWordDocument() {
    const response = await fetch('/api/preview-word', {
        method: 'POST'
    });

    if (!response.ok) {
        throw new Error('The Word preview could not be opened.');
    }

    const { token } = await response.json();
    objViewer.View(token);
}

קרא לפונקציה זו מפעולת התצוגה המקדימה של העמוד שלך והצג כל שגיאה דרך ממשק השגיאות הקיים של היישום. שמור על הבקשה באותו מקור של היישום כמו המציג בדוגמה זו.

שמירת גישה למסמך תחת שליטת היישום

בפורטלים ללקוחות, החלף את הדוגמה הקבועה ברשומת מסמך שנבחרה על‑ידי היישום שלך. ודא שהמשתמש הנוכחי מורשה לצפות ברשומה לפני שמאתרים את מיקום האחסון שלה ופותחים אותה. שם קובץ שמתקבל מהדפדפן אינו החלטת הרשאה.

אחסן את המקור המוגן מחוץ לשורש האינטרנט הציבורי. תיקיית App_Data בדוגמה היא קונבנציית אחסון, לא תכונת בקרת גישה: אל תחשוף אותה דרך מיפוי קבצים סטטיים. שמור על אימות והרשאות מסמך ביישום המארח.

הדפדפן מקבל אסימון צפייה למושב המסמך. התייחס לאסימון זה כלאישור ולא ככתובת קבועה של המסמך. ההתחלה המהירה כוללת גם סגירת מסמך כאשר הקורא עוזב או פותח קובץ אחר.

בדיקת פריסת Word עם קבצים מייצגים

קובץ DOCX ריק אינו מוכיח הרבה על המסמכים שהלקוחות שלך משתמשים בהם. בנה סט הערכה קטן מהתבניות האמיתיות שהיישום שלך צריך להציג, עם מידע רגיש מוסר.

מסמך לבדיקה	מה לבדוק בתצוגה המקדימה
חוזה עם כותרות ותחתיות	תוכן חוזר, מספרי עמודים, ומיקום דף החתימה
הצעה עם גופן תאגידי	החלפת גופנים, גלישת שורות, ורוחב כותרות
דו"ח עם טבלאות רחבות או מקוננות	רוחב עמודות, פיצול שורות, וטקסט שנחתך בגבולות העמוד
מסמך המשלב קטעים בתצוגה אנכית ואופקית	ממדי העמוד והמעבר בין הקטעים
מדריך עם הרבה תמונות	מיקום תמונות, כיתובים, וקריאות כאשר מתקרבים

השווה את התוצאה המרונדרת עם המסמך המקורי המאושר. החלט אילו הבדלים משמעותיים לתהליך העבודה שלך לפני שמתחייבים לאינטגרציה.

Doconut חושפת הגדרות רינדור ספציפיות ל‑Word דרך WordConfig. ה‑תיעוד תצורת הפורמט כולל FontFolders לתיקיות גופנים נוספות, הגדרות גודל נייר, ו‑AutoFitAllTables להתאמת טבלאות. שנה את ההגדרות בכוונה: התאמת טבלה לרוחב הזמין יכולה גם לשנות את הפריסה שאתה מנסה לשמר.

חזור על הבדיקות במארח הפריסה. תצוגה מקדימה שמשתמשת בגופן המותקן במחשב המפתח עשויה להיראות שונה כאשר הגופן חסר בשרת. השתמש בגופנים שהארגון שלך מורשה לפרוס.

בחירת צפייה, עריכה והמרה בנפרד

תצוגת DOCX מקדימה פותרת את שלב הקריאה. היא אינה הופכת את היישום שלך לסביבת עריכת Word.

• קריאה: השתמש במציג כאשר מישהו צריך לבדוק מסמך קיים בתוך תיק, הזמנה או רשומת לקוח.
• עריכה: אם על המשתמשים לשכתב פסקאות ולשמור DOCX מעודכן, הערך זרימת עבודה של עריכה בנפרד. תצוגה מקדימה של קובץ אינה הוכחה לתמיכה בעריכת Word.
• המרה: אם הדרישה היא קובץ להורדה בפורמט אחר, הערך תהליך הייצוא בנפרד מהצגת העמודים.

ה‑סקירת מציג Word עבור .NET מתארת את נתיב הצפייה של משפחת Word של Doconut. השתמש בה כדי לבדוק את התאמת המוצר, ואז השתמש בקבצים שלך כדי להעריך את התנהגות הרינדור החשובה ליישום שלך.

הערכת המציג עם המסמך הקשה ביותר שלך תחילה

התחל עם מסמך שכבר גורם לבקשות תמיכה: חוזה ארוך, דוח עם הרבה טבלאות, או תבנית עם גופנים בלתי רגילים. בדוק את התצוגה המקדימה, נווט כמה עמודים, פתח אותה מחדש במושב רענן, וודא שהיישום הסביבתי אוכף את ההרשאות הנכונות למסמך.

הורד Doconut והפעל את דוגמת .NET 8 עם הקובץ הזה. הערכה מוצלחת תדגים שהמשתמשים יכולים לקרוא את המסמכים שהם מקבלים בפועל, עם פריסה שהצוות שלך בדק ואינטגרציה שהיישום שלך יכול לתחזק.