🤵🏽 ⛹🏼 🛬 "शेयर" अनुबंध - विंडोज 8 मेट्रो अनुप्रयोगों में डेटा ट्रांसफर 💅🏼 👠 🎃

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

या की कुंजी जीत + एच एक संयोजन

एक उदाहरण आपके स्थान को मानचित्र या आपके पसंदीदा फ़ोटो से एक मेल एप्लिकेशन या ट्विटर पर स्थानांतरित करने की क्षमता है।

अनुबंध के कार्यान्वयन "साझा" एक बहुत शक्तिशाली विपणन उपकरण हो सकता है। आप गेम या एप्लिकेशन में अपनी उपलब्धियों को दोस्तों के साथ साझा करने का अवसर प्रदान कर सकते हैं, जो आपके एप्लिकेशन की लोकप्रियता बढ़ाने में मदद कर सकता है।

यहाँ मैं आवेदन जो "rassharivat" डेटा के लिए आवेदन प्रदाता शब्दों का प्रयोग करेंगे। और अनुप्रयोगों के लिए आवेदन रिसीवर rassharennye डेटा ले जा सकते हैं कि।

यह लेख काफी बड़ा रहा है और यहाँ लेख का सारांश दिया गया है:

साझा करना। डेटा प्रदाता
साझा करना। डेटा रिसीवर।
मानक प्रारूप भेजना और प्राप्त करना।
पाठ डेटा प्रारूप भेजना और प्राप्त करना।
लिंक भेजना और प्राप्त करना
ग्राफिक्स भेजना और प्राप्त करना
फाइलें भेजना और प्राप्त करना
भेजा जा रहा है और कस्टम डेटा प्रकार प्राप्त
एक पंक्ति में भेजा जा रहा है और क्रमबद्धता से वस्तुओं को प्राप्त करने
मानक "गैर-मानक प्रकार।" स्कीमा। ओएमए आधारित स्कीमा डेटा
बाइनरी डेटा भेजना और प्राप्त करना
डेटा भेजने विलंबित (संचरण डेटा प्रदाता)।
डेटा की बड़ी मात्रा के हस्तांतरण के समुचित संगठन (संगीत, वीडियो)
पैनल sharinga के लिंक जोड़ने (त्वरित लिंक)
हम तार्किक त्रुटियों को संसाधित करते हैं।
डेटा शेयरिंग में सुधार। सांख्यिकी संग्रह
साझा करने के लिए सामान्य सिफारिशें। हम कार्यान्वयन में त्रुटियों से बचते हैं।
प्रदाता आवेदन के लिए सिफारिशें।
आवेदन प्रदाता के लिए सलाह।

साझाकरण अनुबंध के विस्तृत अध्ययन के लिए, मैं MSDN पर कार्यान्वयन के दो महान उदाहरण डाउनलोड करने की सलाह देता हूं:
सामग्री स्रोत एप्लिकेशन नमूना साझा करना
सामग्री लक्ष्य एप्लिकेशन नमूना साझा करना

साझा करना। डेटा प्रदाता।

डेटा को डिलीवर करने वाले एप्लिकेशन को लागू करना काफी सरल है। मान लीजिए कि हम कुछ पाठ "साझा" करना चाहते हैं।

OnNavigatedTo विधि में पृष्ठ पर, डेटा साझा करने के लिए एक अनुरोध हैंडलर जोड़ें। और OnNavigatingFrom विधि में साझा करने की घटना से सदस्यता समाप्त करें

protected override void OnNavigatedTo(NavigationEventArgs e) { DataTransferManager.GetForCurrentView().DataRequested += Share_DataRequested; } protected override void OnNavigatingFrom(NavigatingCancelEventArgs e) { DataTransferManager.GetForCurrentView().DataRequested -= Share_DataRequested; }

हैंडलर में, हम डेटा है कि हम "साझा" करना चाहते हैं निर्दिष्ट कर सकते हैं। मान लीजिए हम किसी प्रकार का पाठ प्रकाशित करना चाहते हैं।

  void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Simple notepad"; args.Request.Data.Properties.Description = "Publication of the text"; args.Request.Data.SetText("Hello! World!"); }

शीर्षक संपत्ति की आवश्यकता है, इसे निर्दिष्ट किए बिना हमें डेटा को "साझा" करने की कोशिश करते समय एक त्रुटि मिलती है। उसी समय, विवरण गुण वैकल्पिक है।

अब, यदि हम डेटा शेयरिंग कहते हैं, तो हम एक एप्लिकेशन के चयन के प्रस्ताव के साथ दाईं ओर एक पैनल देखेंगे जो डेटा स्वीकार कर सकता है।

मेल एप्लिकेशन को चुने जाने के बाद, हमें एक फॉर्म प्राप्त होगा जहां पत्र का पाठ पहले से ही भरा होगा और प्रेषक का चयन करके हम पत्र भेज सकते हैं। पहले दो बिंदु मेल एप्लिकेशन की पिछली सक्रियताओं से बने रहे।

साझा करना। रिसीवर।

डेटा प्रदाता के "रिसीवर" के रिसीवर आवेदन को लागू करना भी काफी सरल है। यहां हम स्टूडियो में तैयार किए गए टेम्पलेट का उपयोग कर सकते हैं:

इस टेम्पलेट को चुनते समय, हम मेनिफ़ेस्ट में एक प्रविष्टि जोड़ देंगे, App.xaml में विधि को ओवरराइड कर देंगे और एक नया पेज जोड़ देंगे।

हम इस टेम्पलेट के उपयोग पर विचार नहीं करेंगे और "मैन्युअल रूप से" कदम से कदम आवश्यक तत्वों को जोड़ देंगे।

सबसे पहले, मैनिफ़ेस्ट फ़ाइल Package.appxmanifest में, आपको एप्लिकेशन द्वारा साझाकरण अनुबंध के लिए समर्थन जोड़ने की आवश्यकता है, और उस डेटा के प्रकार को इंगित करें जो एप्लिकेशन समर्थन कर सकता है:

यहां हम देख सकते हैं कि हम उरी, बिटमैप, HTML, StorageItems, RTF के लिए समर्थन भी जोड़ सकते हैं।

हम इन डेटा प्रकारों और कस्टम प्रारूपों के लिए समर्थन पर थोड़ी देर बाद चर्चा करेंगे।

अगला, हमें App.xaml में OnShareTargetActivation को फिर से परिभाषित करना होगा और इस पद्धति में हम उस लिंक को स्थानांतरित कर सकते हैं जहां से हम टेक्स्ट को निकाल सकते हैं:

  protected override void OnShareTargetActivated(ShareTargetActivatedEventArgs args) { var frame = new Frame(); frame.Navigate(typeof(TargetPage), args.ShareOperation); Window.Current.Content = frame; Window.Current.Activate(); }

अब TargetPage पेज पर हम ट्रांसफर किए गए टेक्स्ट को निकाल सकते हैं। सादगी के लिए, पृष्ठ पर एक TextBlock जोड़ें और इसके लिए पाठ गुण सेट करें।

ऐसा करने के लिए, पृष्ठ कोड में OnNavigateTo विधि को फिर से परिभाषित करें और पाठ को निकालें

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; txtBlock.Text=await shareOperation.Data.GetTextAsync(); } }

वह सब है। अब, यदि हम रिसीवर एप्लिकेशन इंस्टॉल करते हैं और उसके बाद प्रेषक एप्लिकेशन लॉन्च करते हैं और साझा करते समय हमारे रिसीवर एप्लिकेशन का चयन करते हैं, तो हम निम्नलिखित विंडो देख सकते हैं:

हमारे आवेदन को एक और आवेदन से पारित स्ट्रिंग प्राप्त हुआ।

आपको किस चीज पर ध्यान देना चाहिए। एप्लिकेशन को साइड पॉपअप में एक शीर्षक के साथ प्रदर्शित किया जाता है। जब आप रिसीवर पेज के डिजाइन की योजना हम खाते में रखना चाहिए। (शायद रिलीज का एक अलग मूल्य होगा, लेकिन मेरे कई अलग-अलग मॉनिटरों पर पैनल की चौड़ाई हमेशा 645 पिक्सल थी)।

इसके अलावा, हम शीर्षक को प्रभावित नहीं कर सकते - रिसीवर पृष्ठ शीर्षक (पीछे तीर, आवेदन का नाम और हमारे आवेदन के लोगो) के साथ सक्रिय हो जाएगा। इस संबंध में, आपको इस पृष्ठ पर नेविगेशन के लिए काम करने की आवश्यकता नहीं है। आदर्श रूप से, यह बिना किसी नेविगेशन के एक ही पृष्ठ होना चाहिए।

मानक प्रारूप भेजना और प्राप्त करना।

अक्सर, हमें स्ट्रिंग्स की तुलना में थोड़ा अधिक जटिल डेटा प्रारूप प्रसारित और प्राप्त करने की आवश्यकता होती है। सबसे अधिक अनुरोधित प्रारूपों के लिए, संगत एपीआई समर्थन जोड़ा गया है। हम टेक्स्ट, Rtf, Html, Uri, Bitmap, StorageItems (files) को मानक प्रारूपों के रूप में स्थानांतरित कर सकते हैं। उनमें से प्रत्येक को एक साथ प्रेषित किया जा सकता है। यानी हम एक साथ भेज सकते हैं और निकाल सकते हैं, उदाहरण के लिए, पाठ, एचटीएमएल और बिटमैप

पाठ डेटा प्रारूप भेजना और प्राप्त करना

पहले तीन प्रारूप टेक्स्ट, Rtf, Html प्रेषित होते हैं और उसी तरह प्राप्त होते हैं:

दिखाएँ:

  args.Request.Data.SetText("..."); args.Request.Data.SetRtf("..."); args.Request.Data.SetHtmlFormat("...");

स्वागत:

पाठ, एचटीएमएल, उरी प्रारूपों के "रिसेप्शन" का समर्थन करने के लिए सबसे पहले, हम प्रकट में संबंधित प्रविष्टि को जोड़ते हैं।

और संबंधित डेटा पुनर्प्राप्ति कोड:

  shareOperation.Data.GetTextAsync(); shareOperation.Data.GetRtfAsync(); shareOperation.Data.GetHtmlFormatAsync();

यदि हम एक साथ कई प्रारूपों का समर्थन करते हैं, तो सबसे अधिक संभावना है कि हमें केवल एक विशिष्ट डेटा प्रकार प्राप्त होगा और हमें पैकेज में डेटा की "सामग्री" की जांच करनी चाहिए।

  if(shareOperation.Data.Contains(StandardDataFormats.Text)) { var text = shareOperation.Data.GetTextAsync(); } if(shareOperation.Data.Contains(StandardDataFormats.Html)) { var html = shareOperation.Data.GetHtmlFormatAsync(); } if(shareOperation.Data.Contains(StandardDataFormats.Rtf)) { var rtf = shareOperation.Data.GetRtfAsync(); }

भेजा जा रहा है और लिंक प्राप्त

उरी प्रेषित और प्राप्त लगभग समान हैं:

 args.Request.Data.SetUri(new Uri("http://akhmed.ru/post/2012/07/19/share_contract_win8.aspx"));

स्वागत:

 shareOperation.Data.GetUriAsync();

भेजा जा रहा है और ग्राफिक्स प्राप्त

थोड़ा और दिलचस्प तस्वीर का प्रसारण और रिसेप्शन है।

किसी अन्य सर्वर से चित्रों के रूप में स्थानांतरित कर सकते हैं

 args.Request.Data.SetBitmap(RandomAccessStreamReference.CreateFromUri(new Uri("http://freshyourmood.com/wp-content/uploads/2012/04/pure-water-aquatecuk.wordpress.com_.jpg")));

और स्थानीय परियोजना के

 args.Request.Data.SetBitmap(RandomAccessStreamReference.CreateFromUri(new Uri("ms-appx:///apple.jpg")));

तस्वीरें निकालना भी एक काफी सरल ऑपरेशन है। सबसे पहले, गंतव्य एप्लिकेशन के प्रकट होने के लिए उपयुक्त प्रविष्टि जोड़ें: बिटमैप।

अगला, उदाहरण के लिए, संबंधित xaml कोड में पृष्ठ पर पाठ और छवि प्रदर्शित करें:

  <StackPanel Orientation="Horizontal" VerticalAlignment="Top"> <Image x:Name="img" Width="200" Height="200"></Image> <TextBlock x:Name="txtBlock" Margin="24" Text="start page text" Style="{StaticResource HeaderTextStyle}" /> </StackPanel>

"डेटा निकालने" के लिए कोड:

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation) e.Parameter; if (shareOperation.Data.Contains(StandardDataFormats.Text)) { txtBlock.Text = await shareOperation.Data.GetTextAsync(); } if (shareOperation.Data.Contains(StandardDataFormats.Bitmap)) { var bitmapReference = await shareOperation.Data.GetBitmapAsync(); var bitmapImage = new BitmapImage(); bitmapImage.SetSource(await bitmapReference.OpenReadAsync()); img.Source = bitmapImage; } } }

और हम परिणाम की प्रशंसा कर सकते हैं:

उसी सिद्धांत से, हम आइकन छवियों को स्थानांतरित कर सकते हैं। वाक्यविन्यास थोड़ा अलग दिखता है।

दिखाएँ:

  args.Request.Data.Properties.Thumbnail = RandomAccessStreamReference.CreateFromUri(new Uri("ms-appx:///apple.jpg"));

स्वागत:

  var bitmapReference = shareOperation.Data.Properties.Thumbnail;

इस प्रकार, हम एक बार में दो चित्रों को स्थानांतरित कर सकते हैं, लेकिन प्रदर्शन कारणों से, दूसरे दृष्टिकोण का उपयोग केवल सार्थक है यदि चित्र स्थानीय रूप से स्थित हैं और वे बड़े नहीं हैं।

भेजा जा रहा है और फ़ाइलों को प्राप्त करने

अनुबंधों के माध्यम से, हम सिस्टम में उपलब्ध फाइलों को स्थानांतरित कर सकते हैं। WinRT में डिफ़ॉल्ट रूप से हमारे पास फ़ाइल सिस्टम तक सीधी पहुंच नहीं है और हम प्राप्त फ़ाइलों को स्थानांतरित कर सकते हैं, उदाहरण के लिए, फाइलपिकर अनुबंध के माध्यम से। सामान्य तौर पर, फाइलों के साथ काम करना एक अलग लेख के योग्य है, लेकिन फाइलपिकर अनुबंध का उपयोग करना बहुत सरल है।

उदाहरण के लिए, एप्लिकेशन के साथ काम करते समय, हम अपने एप्लिकेशन में कई फाइलें अपलोड कर सकते हैं।

सादगी के लिए, हम आपके द्वारा चुने गए फ़ाइलों पर बटन पर क्लिक करके जोड़ें:

 <Button Content="LoadFiles" Click="LoadFiles_Click" HorizontalAlignment="Left" Margin="268,82,0,0" VerticalAlignment="Top" Width="139"/>

और उपयोगकर्ता द्वारा चयनित फ़ाइलों के लिंक को सहेजें:

  private IReadOnlyList<StorageFile> files; private async void LoadFiles_Click(object sender, RoutedEventArgs e) { var filePicker = new FileOpenPicker { FileTypeFilter = {"*"} }; files = await filePicker.PickMultipleFilesAsync(); }

अब, हम उन साझाकरण घटनाओं को इंगित करेंगे जिन्हें हम इन फ़ाइलों को स्थानांतरित करना चाहते हैं:

  void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "file sharing"; if(files!=null) { args.Request.Data.SetStorageItems(files); } }

फ़ाइलों के "रिसीवर" का कार्यान्वयन भी काफी सरल है। मैनिफ़ेस्ट में, हमें StorageItems फ़ाइलों के लिए समर्थन जोड़ना होगा या बॉक्स की जाँच करना चाहिए कि कोई फ़ाइल प्रकार का समर्थन करता है

इसके अलावा, उदाहरण के लिए, हम ListBox में फ़ाइलों की सूची:

  <ListBox x:Name="listBox"></ListBox>

और इस सूची में प्राप्त फ़ाइलों के नाम को बांधें

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; var files=await shareOperation.Data.GetStorageItemsAsync(); listBox.ItemsSource = files.Select(i=>i.Name); } }

परिणामस्वरूप, हम निम्नलिखित परिणाम देख सकते हैं:

गैर-मानक डेटा प्रकार भेजना और प्राप्त करना।

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

स्ट्रिंग में क्रमांकन के साथ वस्तुओं को भेजना और प्राप्त करना।

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

इस मामले में, एक विशेष डेटा प्रारूप हमारी मदद कर सकता है।

सबसे पहले, हमें प्रारूप के लिए एक नाम के साथ आने की आवश्यकता है, उदाहरण के लिए, उत्पाद। (शायद हमारे पहले या बाद में, कोई व्यक्ति एक शानदार विचार के साथ एक ही नाम के साथ एक प्रारूप का उपयोग करने के लिए आएगा और उनके प्रारूप को भी नाम देगा उत्पाद, संघर्ष से बचने के लिए आप Product_ {GUID} (उदाहरण के लिए, Product_F6FBDBFB-5703-44F6-ACBE-A2D25EF4D6CE) का उपयोग कर सकते हैं। सादगी के लिए, उत्पाद छोड़ दें)।

मान लें कि हमारे पास रिसीवर और समर्थक दोनों में निम्नलिखित उत्पाद वर्ग हैं:

  public class Product { public string Name { get; set; } public int Count { get; set; } }

और serializer:

  public class JsonSerializer { public static string Serialize<T>(T item) { var dataSerializer = new DataContractJsonSerializer(typeof(T)); var ms = new MemoryStream(); dataSerializer.WriteObject(ms,item); ms.Position = 0; return new StreamReader(ms).ReadToEnd(); } public static T Deserialize<T>(string value) { var dataSerializer = new DataContractJsonSerializer(typeof(T)); return (T)dataSerializer.ReadObject(new MemoryStream(Encoding.UTF8.GetBytes(value))); } }

आपूर्तिकर्ता आवेदन में, अब हम उत्पाद को क्रमबद्ध कर सकते हैं और प्रारूप पहचानकर्ता को निर्दिष्ट करके भेज सकते हैं:

  void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Product sharing"; var product = new Product() { Name = "Bread", Count = 2 }; var productJson = JsonSerializer.Serialize(product); args.Request.Data.SetData("product",productJson); }

"प्राप्तकर्ता" का कार्यान्वयन:

प्राप्तकर्ता के आवेदन में, हमें यह दिखाना होगा कि अब हम उत्पाद प्रारूप का समर्थन करते हैं और उत्पाद प्राप्त करने के लिए निम्नलिखित कोड का उपयोग कर सकते हैं:

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; if(shareOperation.Data.Contains("product")) { var productJson = await shareOperation.Data.GetTextAsync("product"); var product = JsonSerializer.Deserialize<Product>(productJson); txtBlock.Text = product.Name + " " + product.Count; } } }

एप्लिकेशन लॉन्च करके, आप देख सकते हैं कि हमारा डेटा सफलतापूर्वक स्थानांतरित कर दिया गया है।

इस मामले में, हमने पास किया और सामान्य स्ट्रिंग को एक विशेष रूप में प्राप्त किया। हम अभी भी GetTextAsync () को निर्दिष्ट किए बिना स्ट्रिंग प्राप्त कर सकते हैं;

मानक "गैर-मानक प्रकार।" स्कीमा। ओएमए आधारित स्कीमा डेटा

आप अपने स्वयं के स्वामित्व डेटा प्रारूप का उपयोग नहीं करना चाह सकते हैं, लेकिन कोई भी सामान्य प्रारूप।

उदाहरण के लिए, यदि अन्य अनुप्रयोग हैं जो उत्पादों के साथ काम करते हैं, तो इन अनुप्रयोगों के साथ डेटा के रिसेप्शन और ट्रांसमिशन को व्यवस्थित करने के लिए समझ में आता है।

ऐसे मामलों में आधिकारिक तौर पर स्कीमा का उपयोग करने की सिफारिश की जाती है।

सबसे पहले, हमें इकाई के प्रकार (किताबें, संगीत, फिल्म, उत्पाद) को निर्धारित करने की आवश्यकता है

उपयुक्त इकाई का चयन, हमें स्कीमा डेटा के अनुसार JSON में एक स्ट्रिंग संचारित या प्राप्त करना चाहिए।

मान लीजिए कि हम "उत्पाद" (http://schema.org/Product) इकाई का चयन करते हैं

प्रदाता आवेदन कार्यान्वयन:

ऊपर चर्चा की गई देशी प्रारूप को प्रेषित करने के लिए डेटा स्थानांतरण पूरी तरह से अनुरूप है, अंतर केवल JSON प्रारूप में है:

  async void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Product sharing"; var productFormat = @"{ ""type"" : ""http://schema.org/Product"", ""properties"" : { ""name"" : ""{0}"", ""description"" : ""{1}"", ""productID"" : ""{2}"" } }"; var productJson = String.Format(productFormat, "Olive oil", "description of product", "8410660101481"); args.Request.Data.SetData("http://schema.org/Product",productJson); }

रिसीवर अनुप्रयोगों के कार्यान्वयन

इस स्कीमा का समर्थन करने के लिए, हमें मैनिफ़ेस्ट में schema.org/Product डेटा प्रारूप निर्दिष्ट करना होगा

डेटा को पढ़ना पढ़ने लाइन है कि हम इसके बाद के संस्करण पर विचार करने के लिए इसी तरह किया जाता है:

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { shareOperation = (ShareOperation)e.Parameter; var productJson = await shareOperation.Data.GetTextAsync("http://schema.org/Product"); JsonObject productObject = JsonObject.Parse(productJson); JsonObject properties = productObject["properties"].GetObject(); var productId = properties["productID"]; var productName = properties["name"]; var productDescriptions = properties["description"]; } }

बाइनरी डेटा भेजना और प्राप्त करना

कुछ मामलों में, स्ट्रिंग के बजाय बाइनरी डेटा को पास करना आसान है। (उदाहरण के लिए, हमारे पास एक djvu संपादक है और हम कच्चे रूप में डेटा स्थानांतरित करना चाहते हैं)।

हम फाइल को खोल सकते हैं, लिंक को ओपन फाइल से स्ट्रीम में ट्रांसफर कर सकते हैं और रिसीवर एप्लिकेशन में इस स्ट्रीम को पढ़ सकते हैं।

स्मृति में एक धारा से डेटा स्थानांतरित करने के अधिक दिलचस्प उदाहरण पर विचार करें:

  async void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Product sharing"; var product = new Product() { Name = "Bread", Count = 2 }; var stream = new InMemoryRandomAccessStream(); using(var writer=new DataWriter(stream)) { writer.WriteInt32(product.Name.Length); writer.WriteString(product.Name); writer.WriteInt32(product.Count); await writer.StoreAsync(); await writer.FlushAsync(); writer.DetachStream(); } stream.Seek(0); args.Request.Data.SetData("product", stream); }

रिसीवर एप्लिकेशन में हम इस स्ट्रीम को पढ़ और पार्स कर सकते हैं।

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; if (shareOperation.Data.Contains("product")) { var stream = await shareOperation.Data.GetDataAsync("product") as IRandomAccessStream; var product = new Product(); using(var streamReader=new DataReader(stream)) { await streamReader.LoadAsync((uint) stream.Size); var len = streamReader.ReadInt32(); product.Name = streamReader.ReadString((uint) len); product.Count = streamReader.ReadInt32(); } txtBlock.Text = product.Name + " " + product.Count; } } } स्ट्रीम))  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; if (shareOperation.Data.Contains("product")) { var stream = await shareOperation.Data.GetDataAsync("product") as IRandomAccessStream; var product = new Product(); using(var streamReader=new DataReader(stream)) { await streamReader.LoadAsync((uint) stream.Size); var len = streamReader.ReadInt32(); product.Name = streamReader.ReadString((uint) len); product.Count = streamReader.ReadInt32(); } txtBlock.Text = product.Name + " " + product.Count; } } }

विलंबित डेटा भेजना (डेटा प्रदाता स्थानांतरण)

पिछले उदाहरण में एक महत्वपूर्ण कमी है। हम हमेशा डेटा को इनिशियलाइज़ और तैयार करते हैं - भले ही उपयोगकर्ता एप्लिकेशन का उपयोग नहीं करता है और साझाकरण ऑपरेशन को रद्द नहीं करता है। एक विकल्प के रूप में, हम डेटा को साझा नहीं कर सकते हैं लेकिन डेटा प्रदाता और रिसीवर एप्लिकेशन उपयोगकर्ता द्वारा सक्रिय होने के बाद डेटा को पढ़ सकते हैं। चलो डेटा प्रदाता का उपयोग करके डेटा प्रदाता के साथ अंतिम उदाहरण का रीमेक बनाते हैं।

  async void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Product sharing"; args.Request.Data.SetDataProvider("product",BinaryDataHandler); } private async void BinaryDataHandler(DataProviderRequest request) { try { var product = new Product() { Name = "Bread", Count = 2 }; var stream = new InMemoryRandomAccessStream(); using (var writer = new DataWriter(stream)) { writer.WriteInt32(product.Name.Length); writer.WriteString(product.Name); writer.WriteInt32(product.Count); await writer.StoreAsync(); await writer.FlushAsync(); writer.DetachStream(); } stream.Seek(0); request.SetData(stream); } finally { request.GetDeferral().Complete(); } }

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

डेटा की बड़ी मात्रा के हस्तांतरण के समुचित संगठन (संगीत, वीडियो)

उन मामलों में जहां एप्लिकेशन बड़ी मात्रा में डेटा वितरित करता है, हमें उपयोगकर्ता को तब तक प्रतीक्षा करने के लिए मजबूर नहीं करना चाहिए जब तक कि सभी डेटा स्थानांतरित नहीं हो जाते।

उन मामलों में जब हमने पहले ही डेटा का रिसेप्शन पूरा कर लिया है और यदि हमने इंटरफ़ेस में सभी आवश्यक कार्य किए हैं (उदाहरण के लिए, मेल इंटरफ़ेस में Send बटन पर क्लिक करें या सेव बटन जहां उपयोगकर्ता की पुष्टि स्पष्ट रूप से आवश्यक है), हम विधि को कॉल कर सकते हैं:

 shareOperation.ReportCompleted();

जो सिस्टम को सूचित करता है कि सभी डेटा ट्रांसफर ऑपरेशन पूरा हो गए हैं और रिसीवर एप्लिकेशन के साझाकरण इंटरफ़ेस को बंद कर रहा है।

उन मामलों में जहां स्थानांतरित डेटा की मात्रा बहुत बड़ी है, हमें उपयोगकर्ता को प्रतीक्षा करने के लिए मजबूर नहीं करना चाहिए।

हम विधि कॉल कर सकते हैं

 shareOperation.ReportStarted();

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

आगे हमें विधि कहनी चाहिए

  shareOperation.ReportDataRetreived();

जो सिस्टम को सूचित करता है कि हमने पहले ही सभी आवश्यक डेटा निकाल लिए हैं और मूल एप्लिकेशन को मुक्त किया जा सकता है (यदि उपयोगकर्ता इससे पहले बंद हो गया है)।

स्थानांतरण पूरा होने पर, हम विधि को कॉल कर सकते हैं

 shareOperation.ReportCompleted();

या विधि

 shareOperation.ReportError("error description");

डेटा ट्रांसफर में सफलता या त्रुटि की प्रणाली को सूचित करने के लिए।

बाद के मामले में, उपयोगकर्ता को त्रुटि के बारे में एक सूचना प्राप्त होगी और वह त्रुटि देख सकता है यदि वह फिर से साझाकरण खोलता है और स्थानांतरण स्थिति की जांच करने के लिए नीचे दिए गए लिंक का अनुसरण करता है।

इस घटना में कि डेटा ट्रांसफर एप्लिकेशन BackgroundTransferTask का उपयोग करता है, हम सिस्टम को सूचित कर सकते हैं कि हम डेटा ट्रांसफर के इस तरीके का उपयोग उचित विधि को कॉल करके करें:

  shareOperation.ReportSubmittedBackgroundTask();

शेयरिंग पैनल के लिंक जोड़ना।

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

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

आइए देखें कि आप हमारे रिसीवर एप्लिकेशन में एक त्वरित लिंक कैसे जोड़ सकते हैं:

  private async void ButtonSaveLink_Click(object sender, RoutedEventArgs e) { var quickLinkInfo = new QuickLink { Id = "homeListId", Title = "Add to Home list", SupportedFileTypes = { "*" }, SupportedDataFormats = { //   StandardDataFormats.Bitmap, "product" } }; try { var iconFile = await Package.Current.InstalledLocation.CreateFileAsync("assets\\Logo.png", CreationCollisionOption.OpenIfExists); quickLinkInfo.Thumbnail = RandomAccessStreamReference.CreateFromFile(iconFile); shareOperation.ReportCompleted(quickLinkInfo); } catch (Exception) { shareOperation.ReportCompleted(); throw; } }

XAML में कोडिंग कोड

 <Button Content="Save" Click="ButtonSaveLink_Click" />

अब, यदि हम रिसीवर एप्लिकेशन में सेव बटन दबाते हैं, तो हम देखेंगे कि अगली बार साझा करते समय, हमारे पास एक त्वरित लिंक होगा।

अब अगली बार हम उसी प्रकार की क्रिया को सरल बना सकते हैं जिससे यह पता चले कि उपयोगकर्ता ने किस त्वरित लिंक पर क्लिक किया है।

  shareOperation = (ShareOperation)e.Parameter; if(shareOperation.QuickLinkId=="homeListId") { //handle selected list }

इस लिंक को अपने आप क्यों नहीं जोड़ा गया? क्योंकि उपयोगकर्ता अनुप्रयोग को सक्रिय करने के बाद कोई कार्रवाई नहीं कर सकता है।

शेयरिंग एपीआई को विशेष रूप से डिज़ाइन किया गया है ताकि लिंक जोड़ने से गंतव्य एप्लिकेशन कम से कम हो। तदनुसार, एक लिंक जोड़ना अंतिम ऑपरेशन होना चाहिए जो किया जा सकता है। यानी यदि हम रिसीवर एप्लिकेशन का चयन करते हैं और सूची का चयन करते हैं, तो हम तुरंत सहेजते हैं और एक त्वरित लिंक जोड़ते हैं। या एक सूची का चयन करके, हम अपनी पसंद को बदलने का मौका देते हैं और सेव बटन पर क्लिक करने के बाद ही चयनित सूची को बचा सकते हैं।

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

  shareOperation.RemoveThisQuickLink();

हम तार्किक त्रुटियों को संसाधित करते हैं।

यदि स्रोत एप्लिकेशन पृष्ठ डेटा साझाकरण का समर्थन नहीं करता है, जब आप साझा करने का प्रयास करते हैं, तो उपयोगकर्ता संदेश देखेगा "यह ऐप साझा नहीं कर सकता है।"

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

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

उदाहरण के लिए:

  async void Share_DataRequested(DataTransferManager sender, DataRequestedEventArgs args) { args.Request.Data.Properties.Title = "Product sharing"; args.Request.FailWithDisplayText("please select products for sharing"); }

अब हम निम्न परिणाम देख सकते हैं जब "rassharivaniya" पृष्ठ:

डेटा शेयरिंग में सुधार। आंकड़े एकत्रित

करना अपने आप में डेटा साझा करना अनुप्रयोगों के बीच बातचीत के लिए लगभग सार्वभौमिक एपीआई है। डेवलपर्स के रूप में, हमारे पास उपयोगकर्ताओं के लिए जितना संभव हो उतना आरामदायक होने का अवसर है।

आप जानना चाह सकते हैं कि कौन से एप्लिकेशन सबसे अधिक बार डेटा ट्रांसफर करते हैं और किन ऐप्स से सबसे अधिक बार डेटा आता है।

पहले मामले में, हम रिसीवर एप्लिकेशन के लिए समर्थित स्वरूपों की संख्या में सुधार कर सकते हैं, या हमारे रिसीवर एप्लिकेशन में हम सबसे लोकप्रिय प्रदाता से आने वाले डेटा के लिए बेहतर समर्थन जोड़ना चाहते हैं।

यह पता लगाने के लिए कि कौन सा एप्लिकेशन सबसे अधिक बार आपूर्ति करता है, काफी सरल है। हम एप्लिकेशन चयन इवेंट की सदस्यता ले सकते हैं और आंकड़े एकत्र कर सकते हैं

  protected override void OnNavigatedTo(NavigationEventArgs e) { DataTransferManager.GetForCurrentView().DataRequested += Share_DataRequested; DataTransferManager.GetForCurrentView().TargetApplicationChosen += ShareText_TargetApplicationChosen; } protected override void OnNavigatingFrom(NavigatingCancelEventArgs e) { DataTransferManager.GetForCurrentView().DataRequested -= Share_DataRequested; DataTransferManager.GetForCurrentView().TargetApplicationChosen -= ShareText_TargetApplicationChosen; } void ShareText_TargetApplicationChosen(DataTransferManager sender, TargetApplicationChosenEventArgs args) { var targetAppName = args.ApplicationName; //  }

उसी तरह, रिसीवर एप्लिकेशन में हम यह पता लगा सकते हैं कि डेटा किस एप्लीकेशन से हमारे पास पहुंचाया गया है।

  protected async override void OnNavigatedTo(NavigationEventArgs e) { if (e.Parameter != null) { var shareOperation = (ShareOperation)e.Parameter; //   var sourceAppName = shareOperation.Data.Properties.ApplicationName; //Url      (null    ) var sourceAppMarketUrl = shareOperation.Data.Properties.ApplicationListingUri; //  } }

कार्ड साझा करने के कार्यान्वयन के लिए सामान्य सिफारिशों। हम कार्यान्वयन में त्रुटियों से बचते हैं।

यहां प्रस्तुत सभी सिफारिशें आधिकारिक नहीं हैं, कुछ सिफारिशें जो मैंने अपने दम पर लिखी हैं और उन्हें गंभीरता से लिया जाना चाहिए।

प्रदाता आवेदन के लिए सिफारिशें।

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

सबसे सही समाधान एक पृष्ठ पर जाने पर साझा करने पर हस्ताक्षर कर रहा है और इसे छोड़ते समय साझा करने से हटा देना (OnNavigateTo, OnNavigateFrom विधियों)। सादगी के लिए, आप एक आधार पृष्ठ बना सकते हैं जिसमें ये कार्य स्वचालित होंगे।

वैकल्पिक रूप से, आप एप्लिकेशन के सक्रिय होने पर साझा करने के लिए सदस्यता ले सकते हैं, इस स्थिति में, इस बात पर निर्भर करता है कि वर्तमान में कौन सा पृष्ठ सक्रिय है और इसकी स्थिति क्या है, एक साझा प्रबंधक से डेटा की आपूर्ति करने के लिए (उदाहरण के लिए, प्रत्येक पृष्ठ पर सदस्यता लेने और साझा करने से बचने के लिए)।

एक बार में कई प्रारूपों में डेटा की आपूर्ति करना उचित है। यहां तक कि अगर आपके पास एक विशेष टू-डू सूची प्रारूप है, तो टेक्स्ट या एचटीएमएल में डेटा देने की क्षमता प्रदान करें, ताकि उपयोगकर्ता मेल द्वारा वर्तमान टू-डू सूची भेज सकें, उदाहरण के लिए, अपने दोस्तों को।

अपने आवेदन डेटा की बड़ी मात्रा भेजता है, तो यह है कि जल्दी आपरेशन sharinga चल पाएंगे एक डेटा प्रदाता का उपयोग करने के लिए सबसे अच्छा है।

यदि आवश्यक हो, तो आप उपयोगकर्ता को बता सकते हैं कि वर्तमान पृष्ठ पर डिलीवरी के लिए जानकारी है (उदाहरण के लिए, यदि आपके पास कोई गेम है या एप्लिकेशन में गेम तत्व और उपलब्धियां हैं, तो आप उपयोगकर्ता को बता सकते हैं कि डेटा साझा करने के माध्यम से दोस्तों के साथ क्या साझा किया जा सकता है)। आप एक संकेत बटन जोड़ सकते हैं जो साझाकरण पैनल खोलता है।

निम्न कोड साझाकरण पैनल को खोलने का कारण होगा, इसका उपयोग केवल तभी करने की सिफारिश की जाती है जब उपयोगकर्ता एप्लिकेशन में बटन पर क्लिक करता है।

 DataTransferManager.ShowShareUI();

रिसीवर आवेदन के लिए सिफारिशें।

ध्यान रखें कि डेटा एक साथ कई प्रारूपों में आपके आवेदन पर आ सकता है। उपलब्ध स्वरूपों की पूरी सूची पैरामीटर से प्राप्त की जा सकती है: shareOperation.Data.AvailableFormats

आप एक विशेष स्वरूप की उपलब्धता की जाँच कर सकते हैं shareOpertaion.Data.Contains () विधि;

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

एक ही प्रकार के कार्यों को सरल बनाने के लिए, साझाकरण पैनल के लिंक को जोड़ने के लिए, आवश्यकतानुसार उपयोग करने का प्रयास करें।

यदि आप Scheme.org से मानकों के साथ काम कर रहे हैं हमेशा मान लें कि डेटा गलत प्रारूप में आता है और उचित जांच और त्रुटि से निपटने के लिए बाहर ले जाता है।

"शेयर" अनुबंध - विंडोज 8 मेट्रो अनुप्रयोगों में डेटा ट्रांसफर

More articles: