DataPackage.SetDataProvider(String, DataProviderHandler) Metode

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Mengatur delegasi untuk menangani permintaan dari aplikasi target.

public:
 virtual void SetDataProvider(Platform::String ^ formatId, DataProviderHandler ^ delayRenderer) = SetDataProvider;

void SetDataProvider(winrt::hstring const& formatId, DataProviderHandler const& delayRenderer);

public void SetDataProvider(string formatId, DataProviderHandler delayRenderer);

function setDataProvider(formatId, delayRenderer)

Public Sub SetDataProvider (formatId As String, delayRenderer As DataProviderHandler)

Parameter

formatId

String

Platform::String

winrt::hstring

Menentukan format data. Kami menyarankan agar Anda menetapkan nilai ini dengan menggunakan kelas StandardDataFormats .

delayRenderer

DataProviderHandler

Delegasi yang bertanggung jawab untuk memproses permintaan dari aplikasi target.

Contoh

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Xaml.Media.Imaging;
using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Xaml.Media.Imaging;
using Windows.ApplicationModel.DataTransfer;
using Windows.Graphics.Imaging;

namespace ShareMainBetaCS
{
    public sealed partial class ShareFiles : Page
    {
        private StorageFile imageFile = null;
        private RandomAccessStreamReference imageStreamRef = null;
        private RandomAccessStreamReference dataPackageThumbnail = null;
        private IRandomAccessStream imageStream = null;

        public ShareFiles()
        {
            this.InitializeComponent();
            pickImageButton.Click += new RoutedEventHandler(pickImageButton_Click);
            this.ShareSourceLoad();
        }



        async void pickImageButton_Click(object sender, RoutedEventArgs e)
        {
            FileOpenPicker imagePicker = new FileOpenPicker
            {
                ViewMode = PickerViewMode.Thumbnail,
                SuggestedStartLocation = PickerLocationId.PicturesLibrary,
                FileTypeFilter = { ".jpg", ".png", ".bmp", ".gif", ".tif" }
            };

            this.imageFile = await imagePicker.PickSingleFileAsync();

            if (this.imageFile != null)
            {
                this.imageStreamRef = RandomAccessStreamReference.CreateFromFile(this.imageFile);
                this.dataPackageThumbnail = this.imageStreamRef;
                this.imageStream = await this.imageFile.OpenAsync(FileAccessMode.Read);
            }

        }

        public void ShareSourceLoad()
        {
            DataTransferManager datatransferManager;
            datatransferManager = DataTransferManager.GetForCurrentView();
            datatransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
        }

        void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
        {
            e.Request.Data.Properties.Title = "Hello World!";
            e.Request.Data.Properties.Description = "This example shows how to use delayed sharing.";
            if (this.dataPackageThumbnail != null)
            {
                e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
            }
            e.Request.Data.SetDataProvider(StandardDataFormats.Bitmap, 
                    new DataProviderHandler(this.OnDeferredImageRequestedHandler));

        }
        async void OnDeferredImageRequestedHandler(DataProviderRequest request)
        {
            // Here we provide updated Bitmap data using delayed rendering
            if (this.imageStream != null)
            {
                DataProviderDeferral deferral = request.GetDeferral();

                try
                {
                    InMemoryRandomAccessStream inMemoryStream = new InMemoryRandomAccessStream();

                    // Decode the image
                    BitmapDecoder imageDecoder = await BitmapDecoder.CreateAsync(this.imageStream);

                    // Re-encode the image at 50% width and height
                    BitmapEncoder imageEncoder = await BitmapEncoder.CreateForTranscodingAsync(inMemoryStream, imageDecoder);
                    imageEncoder.BitmapTransform.ScaledWidth = (uint)(imageDecoder.OrientedPixelHeight * 0.5);
                    imageEncoder.BitmapTransform.ScaledHeight = (uint)(imageDecoder.OrientedPixelHeight * 0.5);
                    await imageEncoder.FlushAsync();

                    request.SetData(RandomAccessStreamReference.CreateFromStream(inMemoryStream));
                }

                catch (Exception ex)
                {
                    // Handle the exception
                }

                finally
                {
                    deferral.Complete();
                }
            }
        }
        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
        }
    }
}

Keterangan

Gunakan metode SetDataProvider saat aplikasi Anda mendukung format tertentu, tetapi tidak ingin menyediakan data hingga aplikasi target memintanya. Kami mendorong Anda untuk menggunakan metode ini jika aplikasi Anda berbagi konten yang dapat memerlukan waktu pemrosesan yang signifikan; misalnya, berbagi pilihan foto, video, atau file.

Saat Anda menggunakan metode ini, Anda perlu menentukan format dan fungsi. Anda dapat menentukan format dengan menggunakan kelas StandardDataFormats , atau Anda dapat menggunakan nilai string untuk format kustom. Fungsi harus menempatkan data di DataPackage dengan menggunakan metode seperti SetData.

Anda harus menentukan ekstensi StorageItems yang diteruskan ke Target Berbagi.

Metode SetDataProvider berbeda dari metode GetDeferral dari kelas DataRequest . Dengan GetDeferral, aplikasi sumber dapat memanggil fungsi yang segera menempatkan data di objek DataPackage . Metode SetDataProvider adalah untuk operasi berbagi yang lebih kompleks di mana pengemasan data yang akan dibagikan lebih intensif waktu atau intensif sumber daya.