C # में विशेषताएँ लागू करना

विशेषताओं के उपयोग के अधिकांश स्रोत [ 1 , 2 ] वे कहते हैं कि वे "मेटाडेटा या कोड के साथ घोषणात्मक जानकारी को संबद्ध करने के लिए एक प्रभावी तरीका प्रदान करते हैं", परिलक्षित 3 का उपयोग करके प्राप्त किया जा सकता है [ 3 ] । इस लेख के ढांचे में, मैं विशेषताओं के उपयोग का एक लागू उदाहरण दिखाने की कोशिश करूंगा: एक नई व्यावसायिक वस्तु को जोड़ने / संपादित करने के रूप में आवश्यक फ़ील्ड के पूरा होने की जाँच करना।
इससे पहले कि आप अधिक विस्तार से क्लिक करें, कुछ चेतावनी:
1. यदि आपने पहले से ही विशेषताओं के साथ काम किया है, तो आप रुचि नहीं ले सकते।
2. डेमो लिखते समय, महत्वपूर्ण सरलीकरण किए गए थे (उदाहरण के लिए, MVVM की अस्वीकृति) ताकि विशेषताओं के लिए सामग्री की धारणा को सुविधाजनक बनाया जा सके।

तो चलिए शुरू करते हैं। जैसा कि मैंने ऊपर कहा है: "गुण मेटाडेटा या कोड के साथ घोषणात्मक जानकारी को जोड़ने के लिए एक कुशल तरीका प्रदान करते हैं।" यह वही मेटाडेटा क्या है? ज्यादातर मामलों में, यह बस वर्ग, संपत्ति या विधि के बारे में अतिरिक्त जानकारी है जो वर्ग, संपत्ति या विधि के संचालन को प्रभावित नहीं करता है। लेकिन बाहरी, इसके संबंध में, एप्लिकेशन ऑब्जेक्ट इस जानकारी को प्राप्त कर सकते हैं और किसी तरह इसे संसाधित कर सकते हैं। विशेषताओं के उपयोग के हड़ताली उदाहरणों में से एक NonSerializedAttribute विशेषता है [ 4 ] । इस विशेषता के साथ आप अपनी कक्षा के क्षेत्र को चिह्नित कर सकते हैं और यह ठीक उसी तरह काम करेगा जैसे अंकन से पहले। लेकिन यदि आप पहले से ही उपलब्ध नेटवर्क्स में धारावाहिक का उपयोग करने का निर्णय लेते हैं, तो यह क्षेत्र आउटपुट अनुक्रम में नहीं आएगा।
ठीक है, मैंने विशेषताओं के बारे में थोड़ी बात की है, जो लिंक पढ़ना चाहते थे, चलो वास्तव में उदाहरण के लिए आगे बढ़ते हैं।
एक उदाहरण के रूप में, लोगों की सूची को बनाए रखने के सरल कार्य पर विचार करें। किसी व्यक्ति के बारे में जानकारी संग्रहीत करने के लिए, हम इस तरह एक वर्ग का उपयोग करेंगे:

public class Person { [DisplayAttribute(Name="")] [RequiredAttribute()] public string LastName { get; set; } [Display(Name = "")] [Required()] public string FirstName { get; set; } [Display(Name = "")] public string Patronym { get; set; } } 

इस उदाहरण में, मैं आपसे दो बिंदुओं पर ध्यान देने के लिए कहता हूं:
1. "प्रत्यय" विशेषताओं का उपयोग करते समय: विशेषता, आप लिख नहीं सकते।
2. अंतिम नाम और प्रथम नाम आवश्यक विशेषता विशेषता के साथ चिह्नित हैं, लेकिन कोई मध्य नाम नहीं
यदि आप और मैं व्यक्ति वर्ग की एक वस्तु बनाने की कोशिश करते हैं, तो चाहे वह कितनी भी अप्रिय ध्वनि क्यों न हो, हम इसे रिक्त लास्टनाम और फर्स्टनाम फ़ील्ड के साथ बना सकते हैं, क्योंकि यह विशेषता कक्षा के व्यवहार को बिल्कुल प्रभावित नहीं करती है। फिर वह क्यों है? और हम इसे एक व्यक्ति को जोड़ने / संपादित करने के रूप में उपयोग करेंगे ताकि उपयोगकर्ता इन क्षेत्रों को भरने तक संपादन समाप्त न कर सके।
आवेदन का सामान्य दृश्य इस प्रकार होगा:

मानवीय गुणों को संपादित करने के लिए, हम UserControl का उपयोग करेंगे (केवल नीचे का फ़ॉर्म क्यों नहीं):

 <UserControl x:Class="AttributeExample.PersonEditor" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> <StackPanel> <TextBlock Text="" /> <TextBox Text="{Binding LastName,UpdateSourceTrigger=Explicit}" /> <TextBlock Text="" /> <TextBox Text="{Binding FirstName,UpdateSourceTrigger=Explicit}" /> <TextBlock Text="" /> <TextBox Text="{Binding Patronym,UpdateSourceTrigger=Explicit}" /> </StackPanel> </UserControl> 

Cs में इस UserControl की फाइल भी नहीं चढ़ती है। क्या आपने देखा कि बाइंडिंग को किसी बाहरी घटना द्वारा स्रोत पर लागू किया जाता है? [ ५ ]
फिलहाल, हमारे पास पहले से ही इस ऑब्जेक्ट के गुणों के संपादन के लिए व्यावसायिक ऑब्जेक्ट और घटक का वर्णन करने वाला एक वर्ग है। यह एक सार्वभौमिक खिड़की बनाने के लिए बनी हुई है जो व्यापारिक वस्तुओं को संपादित करने के लिए घटकों को दिखाने में सक्षम होगी और आवश्यक क्षेत्रों की पूर्णता की जांच करेगी, और, यदि सब कुछ सही ढंग से भरा गया है, तो यह व्यापारिक वस्तुओं के क्षेत्रों में दृश्य घटकों के बंधन को लागू करेगा।
एक फॉर्म बनाएँ:

 <Window x:Class="AttributeExample.IngeniousWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="IngeniousWindow" MinWidth="300" SizeToContent="WidthAndHeight" > <Window.Resources> <Style TargetType="Button"> <Setter Property="Grid.Row" Value="2" /> <Setter Property="HorizontalAlignment" Value="Right" /> <Setter Property="Width" Value="100" /> </Style> </Window.Resources> <Grid> <Grid.RowDefinitions> <RowDefinition Height="auto" /> <RowDefinition Height="1*" /> <RowDefinition Height="35" /> </Grid.RowDefinitions> <!--   --> <StackPanel x:Name="spErrors" Visibility="Collapsed" Background="#FFCCCC"> <TextBlock Text=" :" /> <ListView x:Name="lvProperties" Background="#FFCCCC" /> </StackPanel> <!--   --> <ContentPresenter Grid.Row="1" x:Name="cpEditor" /> <!--   --> <Button Margin="5" x:Name="btCancel" Content="" Click="btCancel_Click" /> <Button Margin="5,5,110,5" x:Name="btApply" Content="" Click="btApply_Click" /> </Grid> </Window> 

निर्माता को संपादित करें:

 public partial class IngeniousWindow : Window { FrameworkElement _controlForShow = null; public IngeniousWindow(FrameworkElement p_controlForShow) { InitializeComponent(); _controlForShow = p_controlForShow; cpEditor.Content = p_controlForShow; } } 

रद्द करें बटन में एक हैंडलर जोड़ें:

 private void btCancel_Click(object sender, RoutedEventArgs e) { DialogResult = false; } 

और इस उदाहरण में सबसे दिलचस्प बटन हैंडलर स्वीकार है:

 private void btApply_Click(object sender, RoutedEventArgs e) { List<string> requiredPropertyNames = new List<string>(); //   TextBox c   List<TextBox> textBoxes = GetChildTextBoxes(_controlForShow); List<BindingExpression> expressions = new List<BindingExpression>(); //     -   Type buisnesObjectType = _controlForShow.DataContext.GetType(); //   ,       foreach (var item in textBoxes) { //  Binding BindingExpression expression = item.GetBindingExpression(TextBox.TextProperty); if (expression != null) { expressions.Add(expression); //   PropertyInfo property = buisnesObjectType.GetProperty(expression.ParentBinding.Path.Path); //        Attribute attr = property.GetCustomAttribute(typeof(RequiredAttribute)); if (attr != null && string.IsNullOrWhiteSpace(item.Text)) { //  ,   TextBox  ,    string propertyName = property.Name; Attribute description = property.GetCustomAttribute(typeof(DisplayAttribute)); if (description != null) { propertyName = (description as DisplayAttribute).Name; } requiredPropertyNames.Add(propertyName); } } } //   ,   Binding    if (requiredPropertyNames.Count == 0) { foreach (var exp in expressions) { exp.UpdateSource(); } DialogResult = true; } else { // ,     lvProperties.ItemsSource = requiredPropertyNames; spErrors.Visibility = Visibility.Visible; } } 

ऐसा लगता है कि टिप्पणियों में मैंने विस्तार से सब कुछ वर्णित किया, एकमात्र तरीका: GetChildTextBoxes, मैं इसे नहीं दूंगा, यह दृश्य ट्री के माध्यम से चलता है और सभी TextBox का चयन करता है। कौन परवाह करता है, इसे स्रोत डाउनलोड करके देख सकते हैं।
वह सब है। हम बटन जोड़ने और संपादित करने के लिए मुख्य रूप से हैंडलर को तेज करते हैं:

 private void btAdd_Click(object sender, RoutedEventArgs e) { Person person = new Person(); PersonEditor editor = new PersonEditor() { DataContext = person }; IngeniousWindow window = new IngeniousWindow(editor); if (window.ShowDialog().Value) { _people.Add(person); } } private void btEdit_Click(object sender, RoutedEventArgs e) { if (lvPeople.SelectedItem != null) { Person person = lvPeople.SelectedItem as Person; PersonEditor editor = new PersonEditor() { DataContext = person }; IngeniousWindow window = new IngeniousWindow(editor); window.ShowDialog(); } } 

खैर, यह है कि यह कैसा दिखता है:




सूत्र, यदि किसी ने पाठ में लिंक नहीं देखा है, तो यहां डाउनलोड किया जा सकता है (वीएस 11 में परियोजना, यदि वह है)।

Ps एक जिज्ञासु पाठक पूछ सकता है: "और टोपी में चित्र कहाँ है?" ठीक है, मैं यह सोचना चाहूंगा कि यह एक संकेत है कि इस लक्षण की तरह लग रहा है, लेकिन ऐसा नहीं है।

सूत्रों का कहना है:
1. MSDN - पाठ में विशेषताएँ (C # और Visual Basic)
2. dotsite - पाठ में C # के गुण और उनका उपयोग
3. MSDN - पाठ को प्रतिबिंब (C # और विज़ुअल बेसिक)
4. MSDN - NonSerializedAttribute - पाठ को वर्ग
5. MSDN - बाइंडिंग। UpdateSourceTrigger - पाठ के लिए संपत्ति