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)]
class DataTransferManager final
/// [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)]
public sealed class DataTransferManager
[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

Происходит, когда пользователь выбирает целевое приложение в пользовательском интерфейсе Общего доступа.

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

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