.NET में दस्तावेज़ सेटिंग्स के साथ कैसे काम करें
यह गाइड दिखाता है कि Aspose.Words FOSS for .NET में एप्लिकेशन-स्तर की दस्तावेज़ सेटिंग्स के साथ कैसे काम किया जाए: लेगेसी संगतता स्विच, हाइफ़नेशन प्राथमिकताएँ, संग्रहीत मेल-मरज कॉन्फ़िगरेशन, व्यू विकल्प, और लिखने से सुरक्षा। Aspose.Words FOSS for .NET NuGet के माध्यम से या स्रोत से बनाकर उपलब्ध है।
स्टेप-बाय-स्टेप गाइड
चरण 1: लाइब्रेरी प्राप्त करें
रिपॉज़िटरी को क्लोन करके बनाएं Aspose.Words.sln Release कॉन्फ़िगरेशन में, फिर एक प्रोजेक्ट रेफ़रेंस जोड़ें Aspose.Words.csproj अपने स्वयं के .NET प्रोजेक्ट से, जैसा कि वर्णित है इंस्टॉलेशन गाइड. जोड़ें using Aspose.Words; and using Aspose.Words.Settings; किसी भी फ़ाइल के शीर्ष पर जो document settings पढ़ती या लिखती है।
चरण 2: लेगेसी संगतता विकल्प सेट करें
Document.CompatibilityOptions (एक CompatibilityOptions इंस्टेंस) में दर्जनों बूलियन स्विच होते हैं जो विशिष्ट पुराने-Word लेआउट और स्पेसिंग व्यवहारों को पुन: उत्पन्न करते हैं — उदाहरण के लिए GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, और SpacingInWholePoints। आपको जो व्यक्तिगत प्रॉपर्टी चाहिए, उन्हें सीधे सेट करें; OptimizeFor(MsWordVersion) क्लास में मौजूद है लेकिन इस बिल्ड में NotImplementedException फेंकता है, इसलिए कोई शॉर्टकट नहीं है जो एक साथ पूरी संस्करण प्रोफ़ाइल लागू कर सके।
चरण 3: हाइफ़नेशन प्राथमिकताओं को कॉन्फ़िगर करें
Document.HyphenationOptions (एक HyphenationOptions इंस्टेंस) दस्तावेज़ के लिए Word की हाइफ़नेशन प्राथमिकताओं को संग्रहीत करता है: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, और HyphenationZone. ये प्रॉपर्टीज़ सहेजी गई फ़ाइल में अनुरोध को राउंड-ट्रिप करती हैं; क्योंकि इस संस्करण में कोई पेज-लेआउट इंजन नहीं है, हाइफ़नेशन ब्रेक स्वयं Word द्वारा फ़ाइल को खोलने और पेजिनेट करने पर गणना किए जाते हैं, न कि Aspose.Words FOSS द्वारा.
चरण 4: मेल-मर्ज कॉन्फ़िगरेशन को पढ़ें और लिखें
Document.MailMergeSettings (एक MailMergeSettings इंस्टेंस) दस्तावेज़ में दर्ज किए गए मेल-मर्ज कॉन्फ़िगरेशन को संग्रहीत करता है — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, और ViewMergedData — साथ ही Clear() और Clone(). Word के Office Data Source Object तंत्र के माध्यम से जुड़ी बाहरी डेटा स्रोत के लिए, MailMergeSettings.Odso एक Odso इंस्टेंस (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) को उजागर करता है, जिसकी FieldMapDatas और RecipientDatas कलेक्शन फ़ील्ड मैपिंग और प्राप्तकर्ता सूची का वर्णन करती हैं। इस संग्रहीत कॉन्फ़िगरेशन को पढ़ना और लिखना इस ओपन-सोर्स संस्करण में उपलब्ध है; स्वयं मर्ज को लाइव डेटा स्रोत के विरुद्ध चलाना इस पृष्ठ के दायरे से बाहर एक अलग चिंता है।
चरण 5: दस्तावेज़ दृश्य सेटिंग्स को कॉन्फ़िगर करें
Document.ViewOptions (एक ViewOptions इंस्टेंस) नियंत्रित करता है कि Word फ़ाइल को खोलने के बाद कैसे प्रदर्शित करता है: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, और FormsDesign. ये प्रॉपर्टीज़ संग्रहीत प्राथमिकताएँ हैं जो केवल दस्तावेज़ के Word के अपने प्रदर्शन को प्रभावित करती हैं — उनका Aspose.Words FOSS के स्वयं द्वारा प्रोसेस किए जाने पर कोई प्रभाव नहीं है।
चरण 6: राइट प्रोटेक्शन लागू करें
Document.WriteProtection (एक WriteProtection इंस्टेंस) IsWriteProtected और ReadOnlyRecommended को उजागर करता है, जिसमें SetPassword() एक प्रोटेक्शन पासवर्ड स्थापित करने के लिए और ValidatePassword() उम्मीदवार पासवर्ड को उसकी तुलना करने के लिए है। IsWriteProtected = true सेट करने से पहले SetPassword() को कॉल करें, और स्वयं कच्चे पासवर्ड स्ट्रिंग को संग्रहीत या तुलना करने के बजाय ValidatePassword() का उपयोग करें।
सामान्य समस्याएँ और समाधान
CompatibilityOptions.OptimizeFor() throws NotImplementedException. यह मेथड इस बिल्ड में लागू नहीं है। व्यक्तिगत CompatibilityOptions boolean properties जिन्हें आप सीधे आवश्यकता हो, सेट करें।
Changing ViewOptions.ZoomPercent उत्पन्न आउटपुट पर कोई दृश्यमान प्रभाव नहीं डालता है। ViewOptions वर्ड द्वारा पढ़ी गई एक संग्रहीत डिस्प्ले प्रेफ़रेंस है, न कि कुछ Aspose.Words FOSS स्वयं प्रोसेसिंग के दौरान लागू करता है। कोई सुधार आवश्यक नहीं — यह अपेक्षित है।
WriteProtection.ValidatePassword() अप्रत्याशित रूप से लौटाता है false. SetPassword() कभी कॉल नहीं किया गया, या कोई अलग पासवर्ड सेट किया गया था। कॉल करें SetPassword() मान्यकरण से पहले संरक्षित पासवर्ड स्थापित करने के लिए पहले।
मेल-मर्ज कॉन्फ़िगरेशन सहेजा गया है लेकिन मर्ज नहीं चलता है। MailMergeSettings and Odso केवल मर्ज कॉन्फ़िगरेशन को संग्रहीत करें; यह ओपन-सोर्स संस्करण स्वयं मर्ज निष्पादित नहीं करता है। संग्रहीत कॉन्फ़िगरेशन पढ़ें और उसके विरुद्ध अपनी फ़ील्ड-पॉपुलेशन लॉजिक चलाएँ।
अक्सर पूछे जाने वाले प्रश्न
क्या CompatibilityOptions.OptimizeFor() काम करता है?
नहीं — यह इस बिल्ड में NotImplementedException फेंकता है। आपको आवश्यक व्यक्तिगत CompatibilityOptions गुण सीधे सेट करें।
मैं दस्तावेज़ को संपादन से बचाने के लिए पासवर्ड कैसे लगाऊँ?
कॉल WriteProtection.SetPassword() को Document.WriteProtection पर, फिर IsWriteProtected सेट करें ताकि सुरक्षा सक्षम हो।
क्या HyphenationOptions और ViewOptions दस्तावेज़ की दिखावट को बदलते हैं जब Aspose.Words FOSS इसे प्रोसेस करता है?
नहीं। दोनों संग्रहीत प्राथमिकताएँ हैं जो वर्ड स्वयं फ़ाइल को खोलते और प्रदर्शित करते समय लागू करता है; इस संस्करण में सीधे उन पर कार्य करने के लिए कोई पेज-लेआउट इंजन नहीं है।
मैं बाहरी डेटा स्रोत के लिए mail-merge data-source कॉन्फ़िगरेशन कहाँ पा सकता हूँ?
MailMergeSettings.Odso — इसकी FieldMapDatas और RecipientDatas कलेक्शन्स कॉलम मैपिंग और प्राप्तकर्ता समावेशन स्थिति का वर्णन करती हैं।
Document.CompatibilityOptions और Document.ViewOptions में क्या अंतर है?
CompatibilityOptions स्विचेस पुराने-Word लेआउट और स्पेसिंग की अजीबियों को पुनः उत्पन्न करते हैं; ViewOptions नियंत्रित करता है कि Word का अपना इंटरफ़ेस फ़ाइल को कैसे प्रदर्शित करता है (ज़ूम, फ़ॉर्मेटिंग मार्क्स)। न तो इसे Aspose.Words FOSS स्वयं द्वारा गणना किया जाता है।
