क्या किसी को पता है कि कोई एक्सएसडी फ़ाइल है या नहीं, जिसका उपयोग एक्सएमएल दस्तावेज को प्रमाणित करने के लिए किया जा सकता है जो उत्पन्न होता है जब आप सी # प्रोजेक्ट को/डॉक विकल्प के साथ संकलित करते हैं?सी # के लिए जेनरेट किए गए एक्सएमएल दस्तावेज के लिए एक्सएसडी?
मैं उत्पन्न होने के बाद मैन्युअल रूप से उस फ़ाइल को संशोधित करना चाहता हूं और मैं यह पुष्टि करने का एक आसान तरीका ढूंढ रहा हूं कि मैंने फ़ाइल की संरचना को क्षतिग्रस्त नहीं किया है।
धन्यवाद।
आज इस पुराने प्रश्न में ठोकर खाई .. मुझे माइक्रोसॉफ्ट के दस्तावेज को देखकर यह नहीं देखा गया, न ही अन्य परियोजनाओं को देखते हुए मैंने सोचा कि ऐसी स्कीमा विकसित करने में रुचि हो सकती है; अर्थात्, Sandcastle और (लंबे समय से निष्क्रिय) NDoc परियोजनाओं के स्रोत।
अपनी खुद की एक स्कीमा को परिभाषित करने के लिए वापस कदम उठाने के लिए छोटा, एक बात जो मैं सुझा सकता हूं वह कई टूल का उपयोग करना होगा जो एक्सएमएल से एक्सएसडी उत्पन्न करेंगे। माइक्रोसॉफ्ट में विजुअल स्टूडियो और इसके एसडीके के हिस्से के रूप में XSD.EXE शामिल है।
आप डमी स्रोत लिख सकते हैं जो प्रत्येक XML दस्तावेज़ टिप्पणी टैग का उपयोग करता है, इसके लिए XML दस्तावेज़ फ़ाइल का निर्माण करता है, फिर XSD.EXE का उपयोग करें। उस से एक्सएसडी उत्पन्न करने के लिए, और अपनी प्रसंस्करण के बाद एक्सएमएल दस्तावेज़ को सत्यापित करने के लिए इसका इस्तेमाल करें। लेकिन मुझे लगता है कि यह लगता है की तुलना में कम तुच्छ हो सकता है।
इसके अलावा, एक्सएमएल दस्तावेज टिप्पणियां प्रकार और कोड तत्वों का संदर्भ देती हैं, और ऐसी कई चीजें हैं जो एक स्कीमा नहीं पकड़ेंगे; उदाहरण के लिए, यह सत्यापित करना कि <param> टैग का नाम विशेषता अभी भी आपके सी # स्रोत में वास्तविक पैरामीटर नाम को संदर्भित करती है। संकलक बिल्ड समय पर ऐसे तत्वों की पुष्टि करता है। लेकिन अगर आप एक्सएमएल दस्तावेज को पोस्ट-प्रोसेस करते हैं, तो आपको ऐसे कस्टम टूल की आवश्यकता होगी जिसमें मूल सी # स्रोत या जेनरेटेड असेंबली का संदर्भ दिया गया हो ताकि इस तरह के संदर्भों को फिर से सत्यापित किया जा सके।
मैं अंत में खराब हो गई और एक ने लिखा है: XSD for Xml Comments for .NET Documentation
मुझे पता है कि यह एक पुराना उत्तर है, लेकिन मैं सदस्य तत्व नाम विशेषता के प्रारूप पर दस्तावेज़ ढूंढने की कोशिश कर रहा हूं। मैं रेगेक्स देखता हूं, लेकिन इसे समझने के तरीके पर दस्तावेज़ीकरण की तलाश में हूं। – Jeremy
सख्ती से आपके प्रश्न का उत्तर नहीं है लेकिन यहाँ है [एक अनुशंसित टैग सूची] (http://msdn.microsoft.com/en-us/library/5ast78ax। एएसपीएक्स) उपयोग उदाहरणों के लिंक के साथ। नोट: आप पृष्ठ पर लागू विजुअल स्टूडियो संस्करणों का चयन कर सकते हैं। – Steven