다음을 통해 공유

DataPackageView 클래스

  • 참조

정의

네임스페이스:
Windows.ApplicationModel.DataTransfer
편집

DataPackage의 읽기 전용 버전입니다. 공유 콘텐츠를 받는 앱은 콘텐츠를 가져올 때 이 개체를 가져옵니다.

public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
상속
Object Platform::Object IInspectable DataPackageView
특성
ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

예제

다음 코드에서는 DataPackageView를 사용하여 공유되는 텍스트를 가져오는 방법을 보여 있습니다. 이 예제가 제대로 작동하려면 공유 작업에 대한 응답으로 앱이 시작되었는지 감지하는 코드를 추가해야 합니다. 자세한 내용은 텍스트를 받는 방법 항목을 참조하세요.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

설명

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

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

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

버전 기록

Windows 버전 SDK 버전 추가된 값
1511 10586 SetAcceptedFormatId

속성

AvailableFormats

DataPackageView에 포함된 형식을 반환합니다.
Properties

DataPackageView 개체의 데이터에 대한 읽기 전용 속성 집합을 포함하는 DataPackagePropertySetView 개체를 가져옵니다.
RequestedOperation

요청된 작업(예: 복사 또는 이동)을 가져옵니다. 주로 클립보드 작업에 사용됩니다.

메서드

Contains(String)

DataPackageView에 특정 데이터 형식이 포함되어 있는지 확인합니다.
GetApplicationLinkAsync()

DataPackageView 개체의 애플리케이션 링크를 가져옵니다.
GetBitmapAsync()

DataPackageView에 포함된 비트맵 이미지를 가져옵니다.
GetDataAsync(String)

DataPackageView에 포함된 데이터를 가져옵니다.
GetHtmlFormatAsync()

DataPackageView 개체에 저장된 HTML을 가져옵니다.
GetResourceMapAsync()

HTML 콘텐츠에서 참조되는 데이터(예: 이미지)를 가져옵니다.
GetRtfAsync()

DataPackageView에 포함된 RTF(서식 있는 텍스트) 콘텐츠를 가져옵니다.
GetStorageItemsAsync()

DataPackageView 개체에 저장된 파일 및 폴더를 가져옵니다.
GetTextAsync()

DataPackageView 개체의 텍스트를 가져옵니다.
GetTextAsync(String)

DataPackageView 개체의 텍스트를 가져옵니다.
GetUriAsync()

참고

Windows 8.1 후 릴리스에 대해 GetUriAsync를 변경하거나 사용할 수 없습니다. 대신 GetApplicationLink 또는 GetWebLink를 사용합니다.

DataPackageView에 포함된 URI를 가져옵니다.
GetWebLinkAsync()

DataPackageView 개체의 웹 링크를 가져옵니다.
ReportOperationCompleted(DataPackageOperation)

DataPackageView 개체를 사용하여 앱이 완료되었다는 것을 시스템에 알릴 수 있습니다. 주로 클립보드 작업에 사용됩니다.
RequestAccessAsync()

보호 정책으로 보호되는 데이터 패키지의 잠금을 해제하고 액세스할 수 있는 권한을 요청합니다.
RequestAccessAsync(String)

보호 정책으로 보호되는 데이터 패키지의 잠금을 해제하고 액세스할 수 있는 권한을 요청합니다.
SetAcceptedFormatId(String)

허용되는 형식 ID를 설정합니다.
UnlockAndAssumeEnterpriseIdentity()

데이터 패키지의 잠금을 해제하고 이를 위해 엔터프라이즈 ID를 가정합니다.

적용 대상

추가 정보