العمل مع إعدادات المستند
العمل مع إعدادات المستند
ما وراء المحتوى، يحمل مستند Word إعدادات على مستوى التطبيق – مفاتيح توافق قديمة، تفضيلات التهجئة، تكوين دمج البريد المخزن، خيارات العرض، وحالة الحماية من الكتابة. Aspose.Words FOSS لـ .NET يكشف عن هذه عبر Aspose.Words.Settings المجال و مجموعة قليلة من الخصائص على Document. تغطي هذه الصفحة كل مجموعة إعدادات وما تتحكم فيه وما لا تتحكم فيه.
خيارات التوافق
Document.CompatibilityOptions هو مثال CompatibilityOptions يحتوي على عشرات مفاتيح منطقية تعيد إنتاج سلوكيات تخطيط وتباعد محددة لإصدارات Word القديمة – على سبيل المثال GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout, وBalanceSingleByteDoubleByteWidth. اضبط الخصائص التي تحتاجها مباشرةً لتطابق خصائص العرض الخاصة بإصدار Word معين في الأدوات اللاحقة التي تقرأ المستند.
تفضيلات التجزئة
Document.HyphenationOptions هو مثال HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) الذي يخزن تفضيلات التجزئة في Word للمستند. هذه الخصائص تنقل الطلب ذهابًا وإيابًا؛ ولأن هذا الإصدار لا يتضمن محرك تخطيط الصفحات، فإن Aspose.Words FOSS لا يحسب فواصل التجزئة بنفسه – حيث يقوم Word بتطبيقها عند فتح الملف وتصفح الصفحات.
تكوين دمج البريد
Document.MailMergeSettings هو مثال MailMergeSettings يخزن تكوين الدمج البريدي المسجل في المستند: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, و ViewMergedData, بالإضافة إلى Clear() و Clone(). بالنسبة لمصادر البيانات الخارجية المتصلة عبر آلية كائن مصدر البيانات في Office لكلمة Word، يعرّف 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 يتحكم في كيفية عرض Word للملف عند فتحه: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, و FormsDesign. هذه الخصائص تؤثر فقط على عرض Word الخاص بالمستند – ولا تؤثر على طريقة معالجة Aspose.Words FOSS له.
حماية الكتابة
Document.WriteProtection هو مثال WriteProtection (IsWriteProtected, ReadOnlyRecommended) يحتوي على SetPassword() لتحديد كلمة مرور الحماية وValidatePassword() للتحقق من كلمة مرور مرشحة مقابلها.
وحدات القياس
تحدد تعداد MeasurementUnits وحدة القياس التي يجب أن يستخدمها Word في واجهته للمستند.
نصائح وأفضل الممارسات
CompatibilityOptions.OptimizeFor(MsWordVersion)موجود في الفئة لكن تنفيذه غير مكتمل في هذا البناء – يؤدي إلى رميNotImplementedException. عيّن خصائصCompatibilityOptionsالبوليانية الفردية التي تحتاجها مباشرةً بدلاً من الاعتماد علىOptimizeForلتطبيق ملف تعريف نسخة كامل مرة واحدة.MailMergeSettingsandOdsoتخزين دمج البريد configuration التي تم تسجيلها في المستند – قراءة وكتابة هذا التكوين مدعومة، لكن تنفيذ دمج البريد (ملء الحقول من مصدر بيانات حي) غير متضمن في هذه النسخة مفتوحة المصدر.HyphenationOptionsوViewOptionsكلاهما تفضيلات عرض/واجهة مستخدم يطبقها Word نفسه – لا تتوقع أن يؤدي استدعاءDocument.Save()إلى تغيير طريقة لف النص أو ظهوره بناءً على هذه الإعدادات، لأن هذه النسخة لا تتضمن محرك تخطيط الصفحات.- استدعِ
WriteProtection.SetPassword()قبل تمكينIsWriteProtected، واستخدمValidatePassword()للتحقق من كلمة مرور مرشحة بدلاً من تخزين أو مقارنة السلسلة الخام بنفسك. - يمكن الوصول إلى
CompatibilityOptionsوHyphenationOptionsوMailMergeSettingsوViewOptionsوWriteProtectionجميعًا مباشرةً منDocument– لا حاجة للبحث في شجرة العقد عنهم.
مشكلات شائعة
| مشكلة | السبب | إصلاح |
|---|---|---|
CompatibilityOptions.OptimizeFor() يرمي NotImplementedException | غير مُنفّذ في هذا الإصدار | قم بتعيين خصائص CompatibilityOptions البوليانية الفردية بدلاً من ذلك |
| دمج البريد لا يملأ المستند بالبيانات | 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 الفردية التي تحتاجها مباشرة.
كيف أحمي مستندًا بكلمة مرور ضد التعديلات؟
استدعِ WriteProtection.SetPassword() على Document.WriteProtection، ثم عيّن IsWriteProtected لتمكين الحماية.
هل HyphenationOptions و ViewOptions يغيّران طريقة تنسيق المستند؟
لا. كلاهما تفضيلات مخزنة يطبقها Microsoft Word عند فتحه وعرضه للملف. لا تتضمن هذه النسخة محرك تخطيط الصفحات، لذا تمر هذه الإعدادات دون أن يقوم Aspose.Words FOSS نفسه بحساب التخطيط بناءً عليها.
API Reference ملخص
| فئة / تعداد | وصف |
|---|---|
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 | تفضيلات عرض Word (التكبير، علامات التنسيق)، عبر Document.ViewOptions |
WriteProtection | حالة حماية الكتابة للمستند، عبر Document.WriteProtection |
MeasurementUnits | وحدة القياس التي يجب أن يستخدمها Word في واجهته |