عیب‌یابی Aspose.Words FOSS for .NET

این صفحه به مشکلات رایجی که هنگام ساخت و استفاده از Aspose.Words FOSS برای .NET پیش می‌آید می‌پردازد و نحوه رفع آن‌ها را توضیح می‌دهد.

مشکلات ساخت و نصب

dotnet add package Aspose.Words نمی‌تواند بسته را پیدا کند

آن دستور به بسته تجاری Aspose.Words اشاره می‌کند، نه نسخه FOSS — شناسه بسته FOSS Aspose.Words.FOSS است:

dotnet add package Aspose.Words.FOSS

به‌جای آن، git clone را اجرا کنید تا منبع را دریافت کنید، سپس cd را به پوشه کلون‌شده منتقل کنید و dotnet build را روی راه‌حل اجرا کنید:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

سپس یک ارجاع پروژه به Aspose.Words.csproj از برنامهٔ خود اضافه کنید نه یک ارجاع بسته.

ارجاع پروژه پس از کلون کردن حل نمی‌شود

تأیید کنید که ارجاع به Aspose.Words.csproj داخل پوشهٔ کلون‌شدهٔ Aspose.Words-FOSS-for-.NET/Aspose.Words/ اشاره دارد و اینکه راه‌حل ابتدا با موفقیت ساخته شده است (dotnet build Aspose.Words.sln -c Release). کتابخانه هدف .NET Standard 2.0 است، بنابراین هر SDKی که هدف .NET Framework 4.6.2+ یا .NET 6/8/10 باشد می‌تواند به آن ارجاع دهد.

مشکلات بارگذاری

UnsupportedFileFormatException هنگام بارگذاری یک سند

UnsupportedFileFormatException هنگام بارگذاری پرتاب می‌شود وقتی فرمت فایل شناخته نشده یا توسط این نسخه پشتیبانی نمی‌شود. فرمت‌های بارگذاری این نسخه شامل DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown و متن ساده هستند — ارسال مسیر نامعتبر مانند input.doc به سازندهٔ Document این استثنا را برمی‌انگیزد به جای این‌که سند بارگذاری‌شده را برگرداند:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

گرفتن UnsupportedFileFormatException در اطراف سازندهٔ Document به شما امکان می‌دهد پیام واضحی گزارش کنید به جای این‌که استثنا به‌صورت رد‌پای خام منتشر شود.

FileCorruptedException روی فایلی که به‌نظر معتبر می‌رسد

FileCorruptedException هنگام بارگذاری پرتاب می‌شود وقتی که فایل خراب به نظر می‌رسد و قابل تجزیه نیست — به عنوان مثال، فایلی .docx که بستهٔ OOXML مبتنی بر ZIP معتبر نیست، یا فایلی که در حین انتقال کوتاه شده است. فایل را دوباره از منبع آن دریافت کنید و تأیید کنید که به‌درستی باز می‌شود پیش از بارگذاری آن با Document.

IncorrectPasswordException هنگام باز کردن سند محافظت‌شده

این خطا زمانی پرتاب می‌شود که سندی با رمز عبور رمزگذاری شده باشد و رمزی که به overload LoadOptions سازندهٔ Document ارائه شده باشد، گمشده یا نادرست باشد. قبل از بارگذاری، رمز عبور صحیح را از طریق LoadOptions.Password فراهم کنید.

مشکلات ذخیره‌سازی و صادرات

Document.Save() به PDF، XPS یا پسوند تصویر تبدیل می‌شود اما شکست می‌خورد

این نسخه شامل زیرسیستم چیدمان صفحه و رندرینگ نیست، بنابراین Document.Save() نمی‌تواند به PDF، XPS یا فرمت‌های تصویر صادر شود.

به‌جای آن به DOCX، DOCM، DOTX، DOTM، Flat OPC، Markdown یا متن ساده ذخیره کنید — این‌ها قالب‌هایی هستند که این نسخه واقعاً می‌نویسد. نسخهٔ تجاری Aspose.Words برای .NET خروجی PDF، XPS و تصویر را اضافه می‌کند.

شماره‌های صفحه و ورودی‌های فهرست مطالب همیشه ۰ را نشان می‌دهند

Aspose.Words FOSS برای .NET شامل یک موتور ارزیابی کامل فیلد است، بنابراین فیلدهای محتوا مانند DATE و DOCPROPERTY به‌درستی به‌روز می‌شوند. فیلدهایی که به طرح‌بندی صفحه وابسته‌اند — شماره‌های صفحه، NUMPAGES، و ورودی‌های فهرست مطالب — به جای مقدار محاسبه‌شده، به یک جای‌دار 0 ارزیابی می‌شوند، زیرا این نسخه موتور طرح‌بندی که معمولاً سند را صفحه‌بندی می‌کند را شامل نمی‌شود. این رفتار در این نسخه مورد انتظار است، نه یک باگ.

مشکلات امضای دیجیتال

امضای یک سند هیچ تأثیری ندارد

DigitalSignatureUtil.Sign() و APIهای مرتبط با امضا در مدل شیء برای سازگاری ساختاری با محصول تجاری وجود دارند، اما ایجاد امضای جدید در این نسخهٔ FOSS قابل عملکرد نیست — فراخوانی آن‌ها خروجی امضاشده تولید نمی‌کند. این نسخه می‌تواند امضاهای پیشاپیش به سند پیوست‌شده را از طریق Document.DigitalSignatures و DigitalSignatureUtil.LoadSignatures() بررسی و تأیید کند، اما یک جریان کاری امضا به Aspose.Words تجاری برای .NET نیاز دارد.

مشکلات قلم

قلم‌های توکار بزرگتر از حد انتظار هستند

زمانی که EmbedTrueTypeFonts فعال باشد، قلم‌ها به‌صورت فایل‌های کامل جاسازی می‌شوند نه این‌که به زیرمجموعه‌ای محدود به گلیف‌های واقعی استفاده‌شده در سند تقلیل یابند، بنابراین فایل‌های ذخیره‌شده که قلم‌ها را جاسازی می‌کنند بزرگتر از خروجی معادل محصول تجاری هستند. در این نسخه راه‌حلی وجود ندارد — تقلیل قلم‌های توکار گنجانده نشده است.