DataTransferManager Класс

Определение

Пространство имен:

Windows.ApplicationModel.DataTransfer

Программным способом инициирует обмен содержимым с другими приложениями.

public ref class DataTransferManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTransferManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager

Public NotInheritable Class DataTransferManager

Наследование

Object Platform::Object IInspectable DataTransferManager

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере показан типичный способ использования объекта DataTransferManager .

function setupShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", function (e) {
        var request = e.request;
        request.data.properties.title = "Share Demonstration";
        request.data.setText("Hello World!");
    });
}

Комментарии

Класс DataTransferManager — это статический класс, который используется для запуска операций общего доступа. Чтобы использовать класс , сначала вызовите метод GetForCurrentView . Этот метод возвращает объект DataTransferManager , относящееся к активному окну. Затем необходимо добавить прослушиватель событий для события datarequested в объект . Это событие возникает при запуске операции предоставления общего доступа — обычно при нажатии пользователем чудо-кнопки Поделиться, хотя оно также срабатывает, если приложение запускает операцию общего доступа программным способом.

Класс DataTransferManager включает метод ShowShareUI , который можно использовать для программного запуска операции общего доступа.

Класс DataTransferManager также имеет событие TargetApplicationChosen . Используйте это событие, если требуется записать приложения, выбранные пользователем при предоставлении общего доступа к содержимому приложения.

Примечание

Этот класс не является гибким, что означает, что необходимо учитывать его потоковую модель и поведение маршалинга. Дополнительные сведения см. в разделах Потоки и маршалинг (C++/CX) и Использование объектов среда выполнения Windows в многопоточной среде (.NET).

Windows Phone 8

Этот API поддерживается только в собственных приложениях.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	Issupported
1703	15063	ShareProvidersRequested
1709	16299	ShowShareUI(ShareUIOptions)

Методы

GetForCurrentView()	Возвращает объект DataTransferManager , связанный с текущим окном.
IsSupported()	Возвращает значение true, если устройство поддерживает общий доступ, в противном случае — значение false.
ShowShareUI()	Программный запуск пользовательского интерфейса для совместного использования содержимого с другим приложением. Этот API предназначен для универсальная платформа Windows приложений (UWP). Альтернативный API для классического приложения описан в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
ShowShareUI(ShareUIOptions)	Программный запуск пользовательского интерфейса для совместного использования содержимого с другим приложением. Этот API предназначен для универсальная платформа Windows приложений (UWP). Альтернативный API для классического приложения описан в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

События

DataRequested	Происходит при запуске операции общего доступа.
ShareProvidersRequested	Событие, которое активируется при запросе поставщиков общих данных. Он используется в качестве обратного вызова, и поставщики добавляются путем подписки на это событие и вызова ShareProvidersRequestedEventArgs.Providers.Add() в обработчике событий.
TargetApplicationChosen	Происходит, когда пользователь выбирает целевое приложение в пользовательском интерфейсе Общего доступа.

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

• Пример совместного использования исходного приложения содержимого (Windows 10)