डॉक्युमेंट सेटिंग्स के साथ काम करना

दस्तावेज़ सेटिंग्स के साथ काम करना

सामग्री से परे, एक 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 instance है जो दस्तावेज़ में दर्ज मेल-मर्ज कॉन्फ़िगरेशन को संग्रहीत करता है: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, और ViewMergedData, साथ ही Clear() और Clone()। बाहरी डेटा स्रोतों के लिए, जो Word के Office Data Source Object तंत्र से जुड़े हैं, MailMergeSettings.Odso एक Odso instance प्रदान करता है (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) जिसका FieldMapDatas (OdsoFieldMapDataCollection OdsoFieldMapData के: Name, MappedName, Column, Type) और RecipientDatas (OdsoRecipientDataCollection OdsoRecipientData के: Active, Column, Hash, UniqueTag) फ़ील्ड मैपिंग और प्राप्तकर्ता सूची का वर्णन करते हैं।

दस्तावेज़ दृश्य सेटिंग्स

Document.ViewOptions एक ViewOptions instance है जो यह नियंत्रित करता है कि Word फ़ाइल को खोलते समय कैसे प्रदर्शित करे: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, और FormsDesign। ये गुण केवल Word के दस्तावेज़ प्रदर्शन को प्रभावित करते हैं — उनका Aspose.Words FOSS द्वारा प्रोसेसिंग पर कोई असर नहीं होता।

लेखन सुरक्षा

Document.WriteProtection एक WriteProtection instance है (IsWriteProtected, ReadOnlyRecommended) जिसमें SetPassword() है जो सुरक्षा पासवर्ड स्थापित करता है और ValidatePassword() है जो उम्मीदवार पासवर्ड की जाँच करता है।

माप इकाइयाँ

MeasurementUnits enum उन माप इकाइयों को निर्दिष्ट करता है जिन्हें Word को दस्तावेज़ के इंटरफ़ेस में उपयोग करना चाहिए।

सलाह और सर्वोत्तम अभ्यास

• CompatibilityOptions.OptimizeFor(MsWordVersion) क्लास में मौजूद है लेकिन इस बिल्ड में इसका कार्यान्वयन पूर्ण नहीं है — यह NotImplementedException फेंकता है। आपको आवश्यक व्यक्तिगत CompatibilityOptions बूलियन प्रॉपर्टीज़ को सीधे सेट करें, बजाय इसके कि आप OptimizeFor पर भरोसा करके एक ही बार में पूरा संस्करण प्रोफ़ाइल लागू करें।
• MailMergeSettings and Odso मेल-मर्ज को स्टोर करें configuration जो दस्तावेज़ में रिकॉर्ड किया गया था – उस कॉन्फ़िगरेशन को पढ़ना और लिखना समर्थित है, लेकिन एक मेल-मर्ज (लाइव डेटा स्रोत से फ़ील्ड भरना) को निष्पादित करना इस ओपन-सोर्स संस्करण में शामिल नहीं है।
• HyphenationOptions और ViewOptions दोनों डिस्प्ले/UI प्राथमिकताएँ हैं जिन्हें Word स्वयं लागू करता है — इन सेटिंग्स के आधार पर टेक्स्ट रैप या दिखावट बदलने की उम्मीद न रखें, क्योंकि इस संस्करण में पेज-लेआउट इंजन शामिल नहीं है।
• IsWriteProtected को सक्षम करने से पहले WriteProtection.SetPassword() को कॉल करें, और स्वयं कच्चे स्ट्रिंग को संग्रहीत या तुलना करने के बजाय पासवर्ड उम्मीदवार की जाँच करने के लिए ValidatePassword() का उपयोग करें।
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions और WriteProtection सभी सीधे Document से उपलब्ध हैं — इनके लिए नोड ट्री में खोज करने की आवश्यकता नहीं है।

सामान्य समस्याएँ

FAQ

क्या मैं Aspose.Words FOSS का उपयोग करके वास्तविक मेल-मर्ज चला सकता हूँ?

नहीं। MailMergeSettings और Odso आपको दस्तावेज़ में संग्रहीत मर्ज कॉन्फ़िगरेशन को पढ़ने और लिखने की अनुमति देते हैं, लेकिन मेल मर्ज — डेटा स्रोत से फ़ील्ड भरना — इस ओपन-सोर्स संस्करण में शामिल नहीं है।

क्या CompatibilityOptions.OptimizeFor() काम करता है?

नहीं — इस बिल्ड में यह NotImplementedException फेंकता है। इसके बजाय आवश्यक CompatibilityOptions गुणों को सीधे सेट करें।

मैं दस्तावेज़ को संपादन से बचाने के लिए पासवर्ड कैसे लगा सकता हूँ?

Document.WriteProtection पर WriteProtection.SetPassword() को कॉल करें, फिर सुरक्षा सक्रिय करने के लिए IsWriteProtected सेट करें।

क्या HyphenationOptions और ViewOptions दस्तावेज़ की व्यवस्था को बदलते हैं?

नहीं। दोनों संग्रहीत प्राथमिकताएँ हैं जिन्हें Microsoft Word फ़ाइल खोलते और प्रदर्शित करते समय लागू करता है। इस संस्करण में पेज-लेआउट इंजन शामिल नहीं है, इसलिए ये सेटिंग्स Aspose.Words FOSS द्वारा स्वयं लेआउट की गणना किए बिना पारित हो जाती हैं।

API Reference सारांश

यह भी देखें

• Aspose.Words for .NET — Enterprise Documentation