DataRequest 클래스

정의

네임스페이스:

Windows.ApplicationModel.DataTransfer

오류가 발생하는 경우 앱에서 사용자가 공유하려는 콘텐츠를 제공하거나 메시지를 지정할 수 있습니다.

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

상속

Object Platform::Object IInspectable DataRequest

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 코드에서는 DataPackage의 데이터를 다른 앱과 공유할 수 있도록 설정하는 과정의 일부로 DataRequest 개체를 사용하는 방법을 보여줍니다.

//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!");
}

설명

데이터 쿼리 이벤트가 발생할 때 앱에서 DataRequest 개체 를 받습니다. 이 개체를 사용하면 앱이 DataPackage 개체를 사용하여 대상 앱에 데이터를 제공하거나, 지연 개체를 사용하여 함수를 호출하거나, 대상 앱에 오류가 발생했음을 알릴 수 있습니다.

속성

Data	사용자가 공유하려는 콘텐츠가 포함된 DataPackage 개체를 설정하거나 가져옵니다.
Deadline	지연된 렌더링 작업을 완료하기 위한 최종 기한을 가져옵니다. 실행이 최종 기한을 초과하면 지연된 렌더링 결과가 무시됩니다.

메서드

FailWithDisplayText(String)	공유 작업을 취소하고 사용자에게 표시할 오류 문자열을 제공합니다.
GetDeferral()	DataRequestDeferral 개체를 만들고 반환하여 비동기 공유 작업을 지원합니다.