जेनेरिक कक्षाओं के लिए सी # स्रोत फ़ाइलों का नाम कैसे दें

Question

मैं Design Guidelines for Developing Class Libraries में वर्णित सामान्य नामकरण सम्मेलनों से चिपकने की कोशिश कर रहा हूं। मैंने प्रत्येक प्रकार को अपनी स्रोत फ़ाइल में रखा है (और आंशिक कक्षाओं को फ़ाइल नाम के रूप में प्रकार के नाम का उपयोग करके, Naming Conventions for Partial Class Files प्रश्न में वर्णित अनुसार कई फ़ाइलों में विभाजित किया जाएगा)।

उदाहरण:

namespace Demo.Bla       // project 
{ 
    enum FlowDirection { }     // in file FlowDirection.cs 
    class LayoutManager { }    // in file LayoutManager.cs 
} 

namespace Demo.Bla.LayoutControllers  // folder LayoutControllers in project 
{ 
    class StackPanelLayoutController { } // in file LayoutControllers/StackPanelLayoutController 
} 

लेकिन मुझे यकीन है कि मैं स्रोत फ़ाइलें जो सामान्य वर्गों को शामिल नामकरण की एक चालाक रास्ता ले कर आए हैं नहीं कर रहा हूँ। उदाहरण के लिए, मैं वर्गों निम्नलिखित है कि कहते हैं:

namespace Demo.Bla.Collections    // folder Collections 
{ 
    class Map<T> { }      // in file Map.cs (obviously) 
    class Bag { }       // in file Bag.cs (obviously) 
    class Bag<T> : Bag { }     // also in file Bag.cs ??? 
} 

मैं एक ही Bag.cs फ़ाइल में दोनों गैर सामान्य और सामान्य Bag वर्गों के कोड रखना चाहिए? आपकी आदतें क्या हैं?

Answer 1

CoreFX GitHub भंडार में, माइक्रोसॉफ्ट वापस टिक सम्मेलनMatthias Jakobsson के जवाब में वर्णित पीछा कर रहा है अन्य वर्गों के भीतर परिभाषित वर्ग, नाम द्वारा रचित है

partial class ImmutableArray<T>    // ImmutableArray`1+Builder.cs 
{ 
    class Builder { } 
} 

Answer 2

आमतौर पर यदि मेरे पास प्रकार पैरामीटर की संख्या से "अधिभारित" कई प्रकार हैं, तो यह इसलिए है क्योंकि किसी दूसरे से प्राप्त होता है या एक दूसरे को बनाने के लिए उपयोग किया जाता है। मैंने उन्हें एक ही फाइल में रखा है।

एक वैकल्पिक विकल्प उन्हें अलग-अलग फाइलों में विभाजित करना होगा, एक फ़ाइल को "प्राथमिक" एक बनाना होगा, और अन्य लोग बिल्ड फ़ाइल में उस पर निर्भर "आंशिक" प्रश्न के अनुसार, प्रश्न में लिंक किए गए आंशिक वर्ग प्रश्न के अनुसार ।

इस तरह आप विजुअल स्टूडियो में एक दृश्य लिंक के साथ समाप्त हो सकते हैं, लेकिन फिर भी प्रति फ़ाइल एक वर्ग उनके साथ काम करना आसान बनाता है।

Answer 3

मैं अपने जेनेरिक वर्गों के नाम पर एक प्रत्यय 'टी' जोड़ता हूं।

class Bag { }       // in file Bag.cs 
class BagT<T> : Bag { }     // in file BagT.cs 
class BagInputs : BagT<Input>   // in file BagInputs.cs 

आप से पूछा,

मैं एक ही Bag.cs ​​फ़ाइल में दोनों गैर सामान्य और सामान्य बैग वर्गों के कोड रखना चाहिए? आपकी आदतें क्या हैं?

मेरा उपरोक्त सम्मेलन गैर मानक है; मुझे यह स्पष्ट करना चाहिए कि मैं "मेरी आदतें क्या हैं" का उत्तर दे रहा था और जरूरी नहीं कि "आपको क्या करना चाहिए"।

Answer 4

मुझे लगता है कि इस समस्या के लिए आम समाधान इस तरह फ़ाइल को नाम देने के लिए है:

Bag.cs and Bag`1.cs 

इस तरह माइक्रोसॉफ्ट में इस मुद्दे को संभालने है:

{ClassName}`{NumberOfGenericParameters} 

यह आप इस फ़ाइल का नाम देना होगा Asp.net एमवीसी जैसे ढांचे।

Answer 5

मैं कुछ

Bag.cs 
Bag`1.cs 
Bag`2.cs 

का उपयोग कर के रूप में यह है कि क्या Type.Name प्रदर्शित होता है पुस्तकालयों को देखा है।

मैं प्रकार पैरामीटर से अधिक विवरणात्मक होने के लिए तो मैं हाल ही में

Bag.cs 
Bag{T}.cs 
Bag{TKey, TValue}.cs 

उपयोग करने के लिए यह एक प्रारूप है कि यह भी एक्सएमएल टिप्पणियों के द्वारा समर्थित है करते हैं चाहते हैं।

तो मूल रूप से

:

class ImmutableArray { }      // ImmutableArray.cs 
class ImmutableArray<T> { }     // ImmutableArray`1.cs 
... 
class ImmutableDictionary<TKey, TValue> { } // ImmutableDictionary`2.cs 

और के लिए

/// <summary> 
/// ... 
/// Uses the <see cref="T:MyLibrary.Bag{TKey, TValue}" /> class. 
/// </summary>