کار با تنظیمات سند
کار کردن با تنظیمات سند
فراتر از محتوا، یک سند Word تنظیمات سطح برنامه را حمل می‌کند – سوئیچ‌های سازگاری قدیمی، تنظیمات خطوط تیره، پیکربندی ذخیره‌شده ادغام‌نامه، گزینه‌های نمایش، و وضعیت محافظت از نوشتن. Aspose.Words FOSS برای .NET از طریق Aspose.Words.Settings فضای‌نام و چندین ویژگی بر Document. این صفحه هر گروه تنظیمات را پوشش می‌دهد و آنچه را کنترل می‌کند و آنچه را کنترل نمی‌کند توضیح می‌دهد.
گزینه‌های سازگاری
Document.CompatibilityOptions یک نمونه CompatibilityOptions است که ده‌ها سوئیچ بولی را در خود دارد که رفتارهای خاص چینش و فاصله‌گذاری نسخه‌های قدیمی ورد را بازتولید می‌کند — برای مثال GrowAutofit، UseWord2010TableStyleRules، UseWord2002TableStyleRules، AdjustLineHeightInTable، AlignTablesRowByRow، NoExtraLineSpacing، SuppressSpacingAtTopOfPage، SpacingInWholePoints، UseFELayout و BalanceSingleByteDoubleByteWidth. ویژگی‌هایی که نیاز دارید را مستقیماً تنظیم کنید تا نکات رندرینگ نسخه خاصی از ورد را در ابزارهای پایین‌دستی که سند را می‌خوانند، مطابقت دهید.
تنظیمات تفکیک هجا
Document.HyphenationOptions یک نمونه HyphenationOptions است (AutoHyphenation، ConsecutiveHyphenLimit، HyphenateCaps، HyphenationZone) که تنظیمات تفکیک هجا در ورد را برای سند ذخیره می‌کند. این ویژگی‌ها درخواست را به‌صورت دورانی می‌گذارند؛ زیرا این نسخه شامل موتور صفحه‌بندی نیست، Aspose.Words FOSS خود تقسیمات هجا را محاسبه نمی‌کند — ورد این تقسیمات را هنگام باز کردن و صفحه‌بندی فایل اعمال می‌کند.
پیکربندی ادغام ایمیل
Document.MailMergeSettings یک نمونه MailMergeSettings است که پیکربندی ادغام ایمیل ثبت‌شده در سند را در MainDocumentType، CheckErrors، Destination، DataSource، DataType، Query، ConnectString، MailSubject، MailAsAttachment، ActiveRecord و ViewMergedData، به‌همراه Clear() و Clone() ذخیره می‌کند. برای منابع داده خارجی که از طریق مکانیزم Office Data Source Object مایکروسافت ورد متصل می‌شوند، MailMergeSettings.Odso یک نمونه Odso را افشا می‌کند (DataSource، DataSourceType، TableName، ColumnDelimiter، FirstRowContainsColumnNames) که FieldMapDatas آن (OdsoFieldMapDataCollection از OdsoFieldMapData: Name، MappedName، Column، Type) و RecipientDatas آن (OdsoRecipientDataCollection از OdsoRecipientData: Active، Column، Hash، UniqueTag) توصیف‌کنندهٔ نگاشت فیلدها و فهرست دریافت‌کنندگان است.
تنظیمات نمایش سند
Document.ViewOptions یک نمونه ViewOptions است که نحوهٔ نمایش فایل توسط ورد هنگام باز شدن را کنترل می‌کند: ViewType، ZoomType، ZoomPercent، DisplayBackgroundShape، DoNotDisplayPageBoundaries و FormsDesign. این خصوصیات تنها بر نمایش داخلی سند توسط ورد تأثیر می‌گذارند — هیچ‌گونه تأثیری بر نحوهٔ پردازش Aspose.Words FOSS بر روی آن ندارند.
محافظت نوشتن
Document.WriteProtection یک نمونه WriteProtection (IsWriteProtected، ReadOnlyRecommended) است که SetPassword() برای تعیین رمز عبور محافظت و ValidatePassword() برای بررسی یک رمز عبور پیشنهادی در مقابل آن دارد.
واحدهای اندازه‌گیری
enum MeasurementUnits واحد اندازه‌گیری را مشخص می‌کند که ورد باید در رابط کاربری خود برای یک سند استفاده کند.
نکات و بهترین شیوه‌ها
CompatibilityOptions.OptimizeFor(MsWordVersion)در کلاس موجود است اما پیاده‌سازی آن در این نسخه کامل نیست –NotImplementedExceptionرا پرتاب می‌کند. به‌جای تکیه برOptimizeForبرای اعمال یک پروفایل نسخه کامل، ویژگی‌های بولیCompatibilityOptionsمورد نیاز خود را به‌صورت مستقیم تنظیم کنید.MailMergeSettingsandOdsoذخیره ادغام‌نامه configuration که در سند ثبت شده بود – خواندن و نوشتن آن پیکربندی پشتیبانی می‌شود، اما اجرای ادغام‌نامه (پر کردن فیلدها از یک منبع داده زنده) در این نسخه منبع باز گنجانده نشده است.HyphenationOptionsوViewOptionsهر دو تنظیمات نمایش/رابط کاربری هستند که خود Word اعمال می‌کند – انتظار نداشته باشید فراخوانیDocument.Save()نحوه‌ی پیچیده شدن یا نمایش متن را بر اساس این تنظیمات تغییر دهد، زیرا این نسخه موتور چیدمان صفحه را شامل نمی‌شود.- قبل از فعال‌سازی
IsWriteProtected،WriteProtection.SetPassword()را فراخوانی کنید و به‌جای ذخیره یا مقایسه رشتهٔ خام، ازValidatePassword()برای بررسی رمز عبور کاندید استفاده کنید. CompatibilityOptions،HyphenationOptions،MailMergeSettings،ViewOptionsوWriteProtectionهمگی به‌صورت مستقیم ازDocumentقابل دسترسی‌اند – نیازی به جستجوی درخت گره برای یافتن آن‌ها نیست.
مسائل رایج
| مسئله | دلیل | رفع |
|---|---|---|
CompatibilityOptions.OptimizeFor() NotImplementedException را پرتاب می‌کند | در این نسخه پیاده‌سازی نشده است | به جای آن، ویژگی‌های بولی CompatibilityOptions را به صورت جداگانه تنظیم کنید |
| ادغام نامه (mail merge) سند را با داده‌ها پر نمی‌کند | MailMergeSettings فقط پیکربندی ادغام را ذخیره می‌کند؛ اجرا در این نسخه گنجانده نشده است | پیکربندی منبع داده ذخیره‌شده را بخوانید و منطق پرکردن فیلدهای خود را هدایت کنید، یا از نسخهٔ تجاری استفاده کنید Aspose.Words برای .NET |
تغییر ViewOptions.ZoomPercent هنگام پردازش سند تأثیر قابل مشاهده‌ای ندارد | ViewOptions فقط بر نمایش Word تأثیر می‌گذارد، نه پردازش داخلی Aspose.Words FOSS | رفتار مورد انتظار – نیازی به اصلاح نیست |
WriteProtection.ValidatePassword() به‌طور غیرمنتظره false را برمی‌گرداند | SetPassword() ابتدا فراخوانی نشد، یا رمز عبور دیگری تنظیم شد | برای ایجاد رمز عبور محافظت‌شده قبل از اعتبارسنجی، SetPassword() را فراخوانی کنید |
FAQ
آیا می‌توانم از Aspose.Words FOSS برای اجرای یک ادغام ایمیل واقعی استفاده کنم؟
نه. MailMergeSettings و Odso به شما امکان خواندن و نوشتن پیکربندی ادغام ذخیره‌شده در یک سند را می‌دهند، اما اجرای ادغام ایمیلی – پر کردن فیلدها از یک منبع داده – در این نسخه منبع‌باز گنجانده نشده است.
آیا CompatibilityOptions.OptimizeFor() کار می‌کند؟
نه – در این ساخت NotImplementedException را پرتاب می‌کند. به جای آن، ویژگی‌های فردی CompatibilityOptions که نیاز دارید را مستقیماً تنظیم کنید.
چگونه می‌توانم یک سند را با رمز عبور در برابر ویرایش‌ها محافظت کنم؟
روی Document.WriteProtection WriteProtection.SetPassword() را فراخوانی کنید، سپس برای فعال‌سازی محافظت IsWriteProtected را تنظیم کنید.
آیا HyphenationOptions و ViewOptions نحوه چینش سند را تغییر می‌دهند؟
نه. هر دو تنظیمات ذخیره‌شده‌ای هستند که Microsoft Word هنگام باز کردن و نمایش فایل اعمال می‌کند. این نسخه شامل موتور چینش صفحه نیست، بنابراین این تنظیمات بدون Aspose.Words توسط خود FOSS محاسبه چینش عبور می‌کنند.
API Reference خلاصه
| کلاس / Enum | توضیح |
|---|---|
CompatibilityOptions | سوئیچ‌های چیدمان/فاصله‌گذاری نسخه قدیمی Word، از طریق Document.CompatibilityOptions |
Compatibility | شمارشی برای نام‌گذاری گزینه‌های سازگاری فردی |
MsWordVersion | مقادیر نسخه Word که توسط CompatibilityOptions.OptimizeFor() استفاده می‌شود |
HyphenationOptions | تنظیمات جداسازی واژه‌ها، از طریق Document.HyphenationOptions |
MailMergeSettings | پیکربندی ادغام نامه ذخیره‌شده، از طریق Document.MailMergeSettings |
Odso | تنظیمات اتصال Office Data Source Object برای ادغام نامه |
OdsoFieldMapData / OdsoFieldMapDataCollection | نقشه‌برداری ستون به فیلد ادغام برای یک منبع داده ODSO |
OdsoRecipientData / OdsoRecipientDataCollection | وضعیت شامل/مستثنی برای هر گیرنده در ادغام نامه |
ViewOptions | تنظیمات نمایش ورد (بزرگ‌نمایی، علائم قالب‌بندی)، از طریق Document.ViewOptions |
WriteProtection | وضعیت محافظت نوشتاری سند، از طریق Document.WriteProtection |
MeasurementUnits | واحد اندازه‌گیری که ورد باید در رابط کاربری خود استفاده کند |
