अपडेटकॉन्टेक्स्ट फ़ंक्शन

इन पर लागू होता है: कैनवास ऐप्स

वर्तमान स्क्रीन के संदर्भ चर बनाएँ या अद्यतन करें.

अवलोकन

UpdateContext फ़ंक्शन का उपयोग एक ऐसा संदर्भ चर बनाने के लिए करें, जो अस्थायी रूप से कुछ जानकारी को कायम रखता है, जैसे कि उपयोगकर्ता ने बटन या डेटा ऑपरेशन के परिणाम को कितनी बार चुना है.

प्रसंग चर को एक स्क्रीन पर स्कोप किया जाता है, जिसका अर्थ है कि आप एक ऐसा सूत्र नहीं बना सकते हैं, जो किसी अन्य स्क्रीन पर संदर्भ चर को संदर्भित करता है. यदि आपने एक अन्य प्रोग्रामिंग टूल का उपयोग किया है, तो आप एक स्थानीय चर के समान संदर्भ चर के बारे में सोच सकते हैं. अपने ऐप में उपलब्ध ग्लोबल चर के साथ कार्य करने हेतु Set फ़ंक्शन का उपयोग करें.

Power Apps ऐसे सूत्रों पर आधारित होते हैं, जो उपयोगकर्ता द्वारा ऐप के साथ सहभागिता करने पर स्वचालित रूप से पुनर्परिकलन करते हैं. प्रसंग चर इस लाभ की पेशकश नहीं करते हैं और आपके ऐप को बनाने और समझने में कठिन बना सकते हैं. संदर्भ चर का उपयोग करने से पहले, चर के साथ कार्य करना की समीक्षा करें.

वर्णन

संदर्भ चर बनाने या अद्यतन करने के लिए, एकल रिकॉर्ड को UpdateContext फ़ंक्शन पर पास करें. प्रत्येक रिकॉर्ड में, एक स्तंभ का नाम निर्दिष्ट करें, जो चर के नाम और उस मान को परिभाषित करता है या उससे मैच करता है, जिस पर आप उस चर को सेट करना चाहते हैं.

• यदि आप उस चर का नाम निर्दिष्ट करते हैं, जिसे आपने पहले परिभाषित किया है, तो UpdateContext चर के मान को आपके द्वारा निर्दिष्ट मान पर सेट करता है.
• यदि आप उस चर का नाम निर्दिष्ट करते हैं, जो अभी तक मौजूद नहीं है, तो UpdateContext उस नाम से एक चर बनाता है और उस चर के मान को आपके द्वारा निर्दिष्ट मान पर सेट करता है.
• यदि आपने पहले एक चर को परिभाषित किया है, लेकिन उसे इस विशेष UpdateContext सूत्र में निर्दिष्ट नहीं किया है, तो उसका मान वही रहता है.

संदर्भ चर अप्रत्यक्ष रूप से UpdateContext या Navigate फ़ंक्शन का उपयोग करके बनाए जाते हैं. कोई स्पष्ट घोषणा की आवश्यकता नहीं है. यदि आप संदर्भ चर के सभी UpdateContext और Navigate संदर्भों को निकाल देते हैं, तो वह संदर्भ चर मौजूद नहीं रहेगा. एक चर को साफ़ करने के लिए, उसके मान को Blank फ़ंक्शन के परिणाम पर सेट करें.

आप अपने चर के मान, परिभाषाओं और चर दृश्य के साथ उसके उपयोग को फ़ाइल मेनू के तहत ऑथरिंग परिवेश में देख सकते हैं.

आप चर के स्तंभ नाम का उपयोग करके, सूत्र में संदर्भ चर को संदर्भित करते हैं. उदाहरण के लिए, UpdateContext( { ShowLogo: true } )ShowLogo नामक एक संदर्भ चर बनाता है और उसके मान को सही पर सेट करता है. आप सूत्र में ShowLogo नाम का उपयोग करके इस संदर्भ चर के मान का उपयोग कर सकते हैं. आप छवि नियंत्रण के दृश्यमान गुण के लिए ShowLogo को एक सूत्र के रूप में लिख सकते हैं और संदर्भ चर के मान के सही या गलत होने के आधार पर उस नियंत्रण को दिखा या छिपा सकते हैं.

इन विषय में आगे उदाहरण दिखाते हैं कि संदर्भ चर निम्न जानकारी सहित कई प्रकार की जानकारी को कायम रख सकते हैं:

• एकल मान
• रिकॉर्ड
• तालिका
• ऑब्जेक्ट संदर्भ
• सूत्र के सभी परिणाम

ऐप बंद होने तक, संदर्भ चर अपना मान कायम रखता है. यदि आप एक संदर्भ चर को परिभाषित करते हैं और किसी विशेष स्क्रीन पर उसके मान को निर्धारित करते हैं, तो वह जानकारी बरकरार रहती है, भले ही उपयोगकर्ता अलग स्क्रीन पर स्विच कर ले. एक बार ऐप बंद हो जाने पर, संदर्भ चर का मान खो जाएगा और ऐप को फिर से लोड किए जाने पर उसे फिर से बनाना होगा.

प्रत्येक संदर्भ चर को एक स्क्रीन पर स्कोप किया जाता है. यदि आप एक स्क्रीन पर संदर्भ चर को परिभाषित करना और उस चर को दूसरी स्क्रीन से संशोधित करना चाहते हैं, तो आपको Navigate फ़ंक्शन पर आधारित एक सूत्र बनाना होगा. या एक ग्लोबल चर का उपयोग करें.

UpdateContext का कोई वापसी मान नहीं होता है और आप उसका उपयोग केवल व्यवहार सूत्र में कर सकते हैं.

सिंटैक्स

UpdateContext( UpdateRecord )

• UpdateRecord – आवश्यक. एक रिकॉर्ड, जिसमें कम से कम एक स्तंभ का नाम और उस स्तंभ के लिए एक मान होता है. प्रत्येक स्तंभ और आपके द्वारा निर्दिष्ट मान के लिए एक संदर्भ चर बनाया या अद्यतन किया जाता है.

UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )

• ContextVariable1 - आवश्यक. बनाए या अद्यतन किए जाने वाले संदर्भ चर का नाम.
• Value1 - आवश्यक. संदर्भ चर को असाइन किया जाने वाला मान.
• ContextVariable2: Value2, ... - वैकल्पिक. बनाए या अद्यतन किए जाने वाले अतिरिक्त संदर्भ चर और उनके मान.

उदाहरण

सूत्र	वर्णन	परिणाम
UpdateContext( { Counter: 1 } )	संदर्भ चर Counter के मान को 1 पर सेट करते हुए उसे बनाता है या संशोधित करता है.	काउंटर का मान 1 है. आप सूत्र में Counter नाम का उपयोग करके उस चर को संदर्भित कर सकते हैं.
UpdateContext( { Counter: 2 } )	पिछले उदाहरण से Counter संदर्भ चर के मान को 2 पर सेट करता है.	काउंटर का मान 2 है.
UpdateContext( { Name: "Lily", Score: 10 } )	संदर्भ चर के मान को क्रमशः Lily और 10 पर सेट करते हुए उनके Name और Score को बनाता या संशोधित करता है.	Name का मान Lily है और Score का मान 10 है.
UpdateContext( { Person: { Name: "Milton", Address: "1 Main St" } } )	संदर्भ चर Person के मान को रिकॉर्ड पर सेट करते हुए उसे बनाता या संशोधित करता है. रिकॉर्ड में Name और Address नामक दो स्तंभ हैं. Name स्तंभ का मान Milton है और Address स्तंभ का मान 1 Main St है.	व्यक्ति में रिकॉर्ड का मान है { Name:"Milton", Address:"1MainSt" } }. इस रिकॉर्ड को नाम Person के साथ संपूर्ण रूप से संदर्भित करें या इस रिकॉर्ड के व्यक्तिगत स्तंभ को Person.Name या Person.Address के साथ संदर्भित करें.
UpdateContext( { Person: Patch( Person, {Address: "2 Main St" } ) } )	Address स्तंभ के मान को 2 Main St पर सेट करके Person संदर्भ चर अद्यतन करने के लिए Patch फ़ंक्शन के साथ कार्य करता है.	व्यक्ति के पास अब रिकॉर्ड का मान है { Name: "Milton", Address: "2 Main St" } }.

चरण दर चरण उदाहरण 1

1. डिफ़ॉल्ट स्क्रीन को Source नाम दें, एक और स्क्रीन जोड़ें, और उसे Target नाम दें.

2. Source स्क्रीन पर, दो बटन जोड़ें और उनके पाठ गुण को सेट करें, ताकि एक अंग्रेज़ी कहलाए और दूसरा स्पैनिश कहलाए.

3. अंग्रेज़ी बटन के OnSelect गुण को इस व्यंजक पर सेट करें:
   Navigate(Target, ScreenTransition.Fade, {Language:"English"})

4. स्पैनिश बटन के OnSelect गुण को इस व्यंजक पर सेट करें:
   नेविगेट(लक्ष्य, ScreenTransition.Fade, {Language:"Spanish"})

5. Target स्क्रीन पर, एक लेबल जोड़ें और उसके पाठ गुण को इस सूत्र पर सेट करें:
   If(Language="English", "Hello!", "Hola!")

6. Target स्क्रीन पर, सम्मिलित करें टैब में Shapes चुनें और उसके बाद वापस जाएँ तीर चुनें.

7. वापस जाएँ तीर के OnSelect गुण को इस सूत्र पर सेट करें:
   Navigate(Source, ScreenTransition.Fade)

8. Source स्क्रीन से, F5 दबाएँ और उसके बाद किसी एक भाषा के लिए बटन चुनें.

   Target स्क्रीन पर, लेबल उस भाषा में दिखाई देता है, जो आपके द्वारा चुने गए बटन के संगत होती है.

9. Source स्क्रीन पर वापस लौटने के लिए वापस जाएँ तीर चुनें और उसके बाद अन्य भाषा के लिए बटन चुनें.

   Target स्क्रीन पर, लेबल उस भाषा में दिखाई देता है, जो आपके द्वारा चुने गए बटन के संगत होती है.

10. डिफ़ॉल्ट कार्यस्थान पर लौटने के लिए Esc दबाएँ.

चरण दर चरण उदाहरण 2

1. कैनवास अनुप्रयोग खोलें जहां आप इस सूत्र को इस्तेमाल करना चाहते हैं.
2. आदेश पट्टी से नया स्क्रीन चुनकर नया खाली स्क्रीन चुनें.
3. एक बटन जोड़ें, और इसके OnSelect गुण को इस सूत्र में सेट करें:
   UpdateContext( { Name: "Lily", Score: 10 } )