Share via

ShareOperation Класс

  • Ссылка

Определение

Пространство имен:
Windows.ApplicationModel.DataTransfer.ShareTarget
Изменить

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

public ref class ShareOperation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation
Public NotInheritable Class ShareOperation
Наследование
Object Platform::Object IInspectable ShareOperation
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute

Требования к 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)

Примеры

В следующем примере показано, как работать с объектом ShareOperation.

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);
        }
    });
}

Комментарии

Когда пользователь выбирает ваше приложение в качестве целевого объекта действия предоставления общего доступа, активируется событие. Объект, отправляемый этим событием в приложение, содержит экземпляр класса ShareOperation .

Приложение, открытое в настоящее время в качестве целевого объекта общего доступа, не может инициировать дополнительную shareOperation или запустить FileOpenPicker или FileSavePicker.

Все API ShareOperation следует вызывать только после активации CoreWindow для целевого объекта Share. Платформа общего доступа создает запись для операции предоставления общего доступа только после активации окна.

Примечание

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

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

Версия Windows Версия пакета SDK Добавленная стоимость
1709 16299 Контакты

Свойства

Contacts

Возвращает контакты для операции общего доступа.
Data

Содержит объект DataPackage с данными, которыми пользователь хочет поделиться.
QuickLinkId

Строка, содержащая идентификатор Объекта QuickLink.

Методы

DismissUI()

Закрывает область общего доступа.
RemoveThisQuickLink()

Удаляет QuickLink из списка доступных пользователю объектов QuickLink.
ReportCompleted()

Указывает, что операция совместного использования завершена.
ReportCompleted(QuickLink)

Указывает, что операция совместного использования завершена. Включена функция QuickLink, которую система может сохранить в качестве ярлыка для будущих операций общего доступа.
ReportDataRetrieved()

Указывает, что приложение получило содержимое, которым пользователь хочет поделиться.
ReportError(String)

Указывает, что во время операции общего доступа произошла ошибка.
ReportStarted()

Указывает, что приложение начало получать содержимое, которым пользователь хочет поделиться.
ReportSubmittedBackgroundTask()

Указывает, что приложение запросило, чтобы система разрешила выполнение операции общего доступа в качестве фоновой задачи.

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

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