DataRequest 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오류가 발생하는 경우 앱에서 사용자가 공유하려는 콘텐츠를 제공하거나 메시지를 지정할 수 있습니다.
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
- 상속
- 특성
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 개체를 만들고 반환하여 비동기 공유 작업을 지원합니다. |