DataPackage Class

사용자가 다른 응용 프로그램과 교환하려는 데이터를 포함합니다.

구문

public sealed class DataPackage : Object

특성

ActivatableAttribute(NTDDI_WIN8)

DualApiPartitionAttribute()

MarshalingBehaviorAttribute(Agile)

VersionAttribute(NTDDI_WIN8)

구성원

DataPackage클래스에는 다음과 같은 유형의 구성원이 있습니다.

• 생성자
• 이벤트
• 메서드
• 속성

생성자

DataPackage클래스에는 다음 생성자가 있습니다.

이벤트

DataPackage클래스에는 다음 이벤트가 있습니다.

메서드

The DataPackage 클래스 다음 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음에서 메서드를 상속합니다. Object 클래스.

속성

DataPackage클래스 다음 속성이 있습니다.

설명

공유 작업 중에 소스 앱은 공유되는 데이터를 DataPackage 개체에 넣고 처리를 위해 이 개체를 대상 앱에 보냅니다. DataPackage 클래스에는 text, Rtf, Html, Bitmap 및 StorageItems와 같은 기본 형식을 지원하는 메서드가 포함되어 있습니다. 사용자 지정 데이터 형식을 지원하는 메서드도 있습니다. 이러한 형식을 사용하려면 원본 앱과 대상 앱이 사용자 지정 형식이 존재한다는 것을 이미 인식하고 있어야 합니다.

소스 앱에는 데이터를 즉시 제공하지 않고 대신에 SetDataProvider를 사용하여 DataPackage에 대리자를 할당할 수 있는 옵션이 있습니다. 이 프로세스는 소스 앱이 지정된 형식을 지원하지만 대상 앱이 데이터를 요청하지 않는 한 데이터를 생성하고 싶지 않을 때 유용합니다. 예를 들어 소스 앱은 사진 공유를 위한 다양한 이미지 형식을 지원할 수 있습니다. 이러한 서식을0 사용하여 각 이미지의 복사본을 여러 개 만드는 대신 원본 앱은 대상 앱이 특정 서식 형식을 요청할 때 호출되는 대리자를 사용할 수 있습니다.

대상 앱에서 DataPackageView 개체를 사용하여 공유 중인 데이터에 액세스할 수 있습니다. 또한 이러한 앱은 AvailableFormats 속성을 사용하여 DataPackageView가 지원하는 형식을 식별하거나 Contains 메서드를 사용하여 특정 형식에 대해 쿼리할 수 있습니다.

예제

//To see this code in action, add a call to ShareSouceLoad 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!");
}

요구 사항