DataPackageView 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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 DataPackageViewPublic NotInheritable Class DataPackageView- 상속
- 특성
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를 가정합니다. |