DataRequest.Data 속성

정의

네임스페이스:

Windows.ApplicationModel.DataTransfer

사용자가 공유하려는 콘텐츠가 포함된 DataPackage 개체를 설정하거나 가져옵니다.

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

속성 값

DataPackage

사용자가 공유하려는 콘텐츠를 포함합니다.

예제

다음 코드에서는 DataPackage에서 다른 앱과 공유할 데이터를 설정하는 과정의 일부로 Data 속성에서 DataPackage 개체를 가져오는 방법을 보여 있습니다.

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

설명

Data 속성을 사용하면 앱에서 대상 앱에 데이터를 제공할 수 있습니다. 앱은 DataPackage 개체를 사용하여 이 데이터를 제공해야 합니다.

앱에 사용자가 공유하려는 콘텐츠를 즉시 사용할 수 있는 경우 이 속성을 사용합니다. DataPackage를 생성하기 위해 함수를 호출해야 하는 경우 GetDeferral 메서드를 사용합니다.

앱에서 DataPackage 개체를 제공할 수 없는 경우 FailWithDisplayText 메서드를 사용하여 공유를 취소하고 대상 앱이 사용자에게 표시할 수 있는 메시지를 제공합니다.