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

Возвращает объект DataPackagePropertySetView , содержащий доступный только для чтения набор свойств для данных в объекте DataPackageView .
RequestedOperation

Возвращает запрошенную операцию (например, копирование или перемещение). В основном используется для действий буфера обмена.

Методы

Contains(String)

Проверяет, содержит ли DataPackageView определенный формат данных.
GetApplicationLinkAsync()

Возвращает ссылку на приложение в объекте DataPackageView .
GetBitmapAsync()

Возвращает растровое изображение, содержащееся в DataPackageView.
GetDataAsync(String)

Возвращает данные, содержащиеся в DataPackageView.
GetHtmlFormatAsync()

Возвращает HTML-код, хранящийся в объекте DataPackageView .
GetResourceMapAsync()

Возвращает данные (например, изображение), на которые ссылается HTML-содержимое.
GetRtfAsync()

Возвращает содержимое в формате RTF, содержащееся в DataPackageView.
GetStorageItemsAsync()

Возвращает файлы и папки, хранящиеся в объекте DataPackageView .
GetTextAsync()

Возвращает текст в объекте DataPackageView .
GetTextAsync(String)

Возвращает текст в объекте DataPackageView .
GetUriAsync()

Примечание

GetUriAsync может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте GetApplicationLink или GetWebLink.

Возвращает универсальный код ресурса (URI), содержащийся в DataPackageView.
GetWebLinkAsync()

Возвращает веб-ссылку в объекте DataPackageView .
ReportOperationCompleted(DataPackageOperation)

Сообщает системе о завершении работы приложения с помощью объекта DataPackageView . В основном используется для операций буфера обмена.
RequestAccessAsync()

Запрашивает разрешение на разблокировку и доступ к пакету данных, защищенному с помощью политики защиты.
RequestAccessAsync(String)

Запрашивает разрешение на разблокировку и доступ к пакету данных, защищенному с помощью политики защиты.
SetAcceptedFormatId(String)

Задает идентификатор принятого формата.
UnlockAndAssumeEnterpriseIdentity()

Разблокирует пакет данных и предполагает наличие корпоративного удостоверения для него.

Применяется к

См. также раздел