🔞 🔭 📵 विंडोज फोन 7 के लिए शुरू से आखिर तक एक एप्लिकेशन बनाएं। भाग 14. इनपुट डेटा की मान्यता 🌝 💓 😨

पिछला हिस्सा

संभावित त्रुटियों को रोकने के लिए आपके एप्लिकेशन को सभी उपयोगकर्ता इनपुट की जांच करनी चाहिए।

इस भाग में आप सीखेंगे:

विंडोज फोन पर सत्यापन कैसे करें।
जब उपयोगकर्ता बैक बटन पर क्लिक करता है तो सहेजे न गए परिवर्तनों की जाँच कैसे करें।

मान्यता

यह आमतौर पर उन डेटा को सीमित करने के लिए उपयोगी है जो उपयोगकर्ता दर्ज कर सकते हैं। यहाँ दो सरल तरीके हैं जिनसे आप उपयोगकर्ता इनपुट को सीमित कर सकते हैं:

TextBox.MaxLength संपत्ति सेट करें ताकि उपयोगकर्ता केवल पाठ की अपेक्षित राशि दर्ज कर सकें।
TextBox.InputScope गुण सेट करें ताकि उपयोगकर्ता केवल अपेक्षित डेटा प्रकार (जैसे डिजिटल डेटा) दर्ज कर सकें। यह कैसे करें "नियंत्रण का उपयोग करना" अनुभाग में वर्णित किया गया था।

यहां तक कि इन प्रतिबंधों के साथ, एक नियम के रूप में, आप अभी भी उन मूल्यों को दर्ज कर सकते हैं जो गलत तरीके से स्वरूपित या अन्य कारणों से अमान्य हैं।

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

निम्न कोड Fillup वर्ग में प्रयुक्त सरल सत्यापन विधि प्रदर्शित करता है।

public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .
public IEnumerable < string > Validate() { if (OdometerReading <= 0) yield return "The odometer value must be greater than zero." ; if (DistanceDriven <= 0) yield return "The odometer value must be greater than the previous value." ; if (FuelQuantity <= 0) yield return "The fuel quantity must be greater than zero." ; if (PricePerFuelUnit <= 0) yield return "The fuel price must be greater than zero." ; } * This source code was highlighted with Source Code Highlighter .

निम्न छवि एक संदेश का एक उदाहरण दिखाती है जो तब दिखाई देता है जब आप सहेजें बटन पर क्लिक करते हैं जब ओडोमीटर रीडिंग पिछले मूल्य से कम होती है।

यह कोड केवल फिलअप संपत्ति के मूल्यों की जांच करता है और किसी भी अवैध मूल्यों के लिए त्रुटि संदेश देता है। हालांकि, सभी चेक किए गए मान उपयोगकर्ता द्वारा निर्दिष्ट नहीं किए जाते हैं, इसलिए कुछ आरंभीकरण पहले से होना चाहिए। विशेष रूप से, दूरी की गणना पिछले ओडोमीटर पढ़ने के साथ Fillup.OdometerReading मान की तुलना करके की जानी चाहिए। हालांकि, वर्तमान फ़िलअप ऑब्जेक्ट में पिछले मान तक पहुंच नहीं है, इसलिए यह क्रिया CarDataStore.SaveFillup विधि द्वारा की जाती है, जैसा कि निम्नलिखित कोड टुकड़ा में दिखाया गया है।

सार्वजनिक स्थैतिक SaveResult SaveFillup (Fillup फिलअप, एक्शन त्रुटि कॉलबैक)
{
var अंतिम उत्तर =
कार.फिलुपहिस्ट्रिक्स .ाउंट> 0?
कार.फिलअपहिस्टार। फ़र्स्ट ()। ओडोमीटर रीडिंग:
Car.InitialOdometerReading;
fillup.DistanceDriven = fillup.OdometerReading - lastReading;
var saveResult = new SaveResult ();
var validationResults = fillup.Validate ();
अगर (सत्यापन। वयस्क .ाउंट) ()> 0)
{
saveResult.SaveSuccessful = false ;
saveResult.ErrorMessages = validationResults;
}
अन्यथा
{
कार.फिलुपहिस्ट्री.इंटर (0, फिलअप);
saveResult.SaveSuccessful = true ;
सेवकर ( प्रतिनिधि )
saveResult.SaveSuccessful = false ;
errorCallback (); });
}
saveResult;
}
* इस सोर्स कोड को सोर्स कोड हाइलाइटर के साथ हाइलाइट किया गया था।

CarDataStore.SaveFillup पद्धति बचत के लिए एक फ़िलअप ऑब्जेक्ट और त्रुटि से निपटने के लिए एक एक्शन प्रतिनिधि को स्वीकार करती है। यह विधि वर्तमान ओडोमीटर रीडिंग से पिछले रीडिंग को घटाकर और फिलअप में परिणाम को जमा करके शुरू होती है। डिटेंस डायरियन प्रॉपर्टी में ताकि दूध की जांच इस क्लास में की जा सके। इसके बाद, SaveFillup पद्धति Fillup.Validate विधि को कॉल करती है और परिणामों को एक विशेष SaveResult ऑब्जेक्ट पर सहेजती है, जिसे वह कॉलिंग विधि पर वापस लाती है । यदि सत्यापन त्रुटियाँ नहीं होती हैं, तो SaveFillup विधि ईंधन भरने और वाहन डेटा को बचाता है। अंत में, SaveFillup विधि एक SaveResult ऑब्जेक्ट देता है।

नोट:
विंडोज फोन के लिए सिल्वरलाइट बाइंडिंग के माध्यम से बुनियादी बाध्यकारी-सक्षम सत्यापन प्रदान करता है। ValidatesOnException संपत्ति। हालांकि, विंडोज फोन के लिए नियंत्रण संस्करण सत्यापन पैटर्न प्रदान नहीं करते हैं। सत्यापन का समर्थन करने के लिए, एक विकल्प नियंत्रण के लिए अपना स्वयं का सत्यापन टेम्पलेट प्रदान करना है।

निम्न कोड स्निपेट दर्शाता है कि जब उपयोगकर्ता ईंधन भरने की जानकारी पृष्ठ पर "सहेजें" बटन पर क्लिक करता है तो क्या होता है।

निजी शून्य SaveButton_Click ( ऑब्जेक्ट प्रेषक, EventArgs e)
{
कमेटबॉक्स ();
SaveResult परिणाम = CarDataStore.SaveFillup (currentFillup,
प्रतिनिधि {
MessageBox.Show ( "आपके फोन पर" + के लिए पर्याप्त स्थान नहीं है
"अपना भरने का डेटा सहेजें। कुछ जगह खाली करें और फिर से प्रयास करें।" ।
"चेतावनी" , MessageBoxButton.OK);
});
यदि (परिणाम। असफल)
{
Microsoft.Phone.Shell.PhoneApplicationService.Current
.State [ "FillupSaved" ] = true ;
cacheChanges = false ;
NavigationService.GoBack ();
}
अन्यथा
{
string errorMessages = स्ट्रिंग। जॉइन (
पर्यावरण। पर्यावरण + पर्यावरण।
result.ErrorMessages.ToArray ());
अगर ( स्ट्रिंग .IsNullOrEmpty (errorMessages))
{
MessageBox.Show (errorMessages,
"चेतावनी: अमान्य मान" , MessageBoxButton.OK);
}
}
}
* इस सोर्स कोड को सोर्स कोड हाइलाइटर के साथ हाइलाइट किया गया था।

यह कोड SaveFillup पद्धति को कॉल करता है, इसे कॉलबैक त्रुटि से गुजरता है, जैसा कि ऊपर वर्णित है। यह प्रतिनिधि केवल संदेश बॉक्स में त्रुटि स्थिति प्रदर्शित करता है। तब विधि जांचती है कि क्या सत्यापन की त्रुटियां हैं, तो ईवेंट हैंडलर उन्हें संदेश बॉक्स में प्रदर्शित करता है।

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

केवल एक सत्यापन विधि यहाँ वर्णित है, लेकिन इसके अतिरिक्त और भी कई हैं।

वापस जाने पर सहेजे न गए परिवर्तनों की जाँच करें

डिफ़ॉल्ट रूप से, बैक बटन दबाने से वापस कूदता है। यदि आपके पास बिना परिवर्तन किए डेटा प्रविष्टि पृष्ठ है, और उपयोगकर्ता बैक बटन पर क्लिक करता है, तो आपको उपयोगकर्ता को इस बारे में सूचित करना चाहिए। इस व्यवहार को कार्यान्वित करने के लिए, आप PhoneApplicationPage.OnBackKeyPress पद्धति को अधिभारित कर सकते हैं और सहेजे गए परिवर्तनों की जाँच कर सकते हैं। यदि कोई परिवर्तन नहीं किए गए हैं, तो आप उपयोगकर्ता को इस बारे में सूचित कर सकते हैं और संभवतः संक्रमण वापस कर सकते हैं।

प्रमाणन की आवश्यकता:
एक सुसंगत उपयोगकर्ता अनुभव का समर्थन करने के लिए, बैक बटन का उपयोग केवल एप्लिकेशन में वापस जाने के लिए किया जाना चाहिए।

इस आवश्यकता को पूरा करने के लिए, आपको पिछड़े संक्रमण को पूर्ववत करने के लिए OnBackKeyPress overload का उपयोग नहीं करना चाहिए और पूरी तरह से बैक बटन के व्यवहार को बदलना चाहिए। बैकवर्ड नेविगेशन को रद्द करने की क्षमता आवश्यक नेविगेशन से संबंधित संचालन करने के लिए प्रदान की जाती है, जैसे कि उपयोगकर्ता को डेटा हटाने की पुष्टि करने के लिए प्रतीक्षा करना।
फ्यूल ट्रैकर में डेटा एंट्री के लिए दो पेज हैं: CarDetailsPage और FillupPage । यदि इन पृष्ठों पर सहेजे नहीं गए परिवर्तन हैं और उपयोगकर्ता "बैक" पर क्लिक करता है, तो स्क्रीन पर एक संदेश दिखाई देता है जिसमें पुष्टि की आवश्यकता होती है, जो आपको संक्रमण वापस रद्द करने की अनुमति देता है। निम्न छवि पुष्टि के लिए एक उदाहरण संदेश दिखाती है।

इंटरफ़ेस डिजाइन सिफारिश:
डेटा को ओवरराइट करने या हटाने या रद्द नहीं किए जा सकने वाले एप्लिकेशन कार्यों में एक रद्द बटन होना चाहिए।
निम्न कोड स्निपेट दिखाता है कि फ्यूल ट्रैकर एप्लिकेशन किसी मैसेज को प्रदर्शित करने के लिए PhoneApplicationPage.OnBackKeyPress विधि को ओवरलोड करता है, जिसमें बिना सहेजे गए डेटा की पुष्टि की आवश्यकता होती है।

संरक्षित ओवरराइड शून्य OnBackKeyPress (
सिस्टम .ComponentModel.CancelEventArgs ई)
{
आधार .OnBackKeyPress (e);
// यदि कोई परिवर्तन नहीं हैं, तो कुछ भी न करें।
अगर (है! हैनवेड चेंजेज) वापसी ;
var result = MessageBox.Show ( "आप अपने" + को त्यागने वाले हैं
"परिवर्तन। जारी रखें?" , "चेतावनी" , MessageBoxButton.OKCancel);
अगर (परिणाम == MessageBoxResult.OK)
{
// सामान्य नेविगेशन; tombstoning को संभालने की कोई आवश्यकता नहीं है,
// इसलिए cacheChanges ध्वज सेट करें और वर्तमान कैश को साफ़ करें।
cacheChanges = false ;
इसे .State.Remove (CURRENT_FILLUP_KEY);
}
अन्यथा
{
// पिछड़ा नेविगेशन रद्द करें।
e.Cancel = true ;
}
}
* इस सोर्स कोड को सोर्स कोड हाइलाइटर के साथ हाइलाइट किया गया था।

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

अगले भाग के लिए एक लिंक होगा।
पहला भाग

विंडोज फोन 7 के लिए शुरू से आखिर तक एक एप्लिकेशन बनाएं। भाग 14. इनपुट डेटा की मान्यता

मान्यता

वापस जाने पर सहेजे न गए परिवर्तनों की जाँच करें

More articles: