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。

只有在 激活 Share 目标的 CoreWindow 之后，才应调用所有 ShareOperation API。 仅在激活窗口后，Share 平台才会为共享操作创建一个条目。

注意

此类不敏捷，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅线程和封送处理 (C++/CX) 和使用多线程环境中的Windows 运行时对象 (.NET) 。

版本历史记录

Windows 版本 SDK 版本 已添加值
1709 16299 联系人

属性

Contacts

获取共享操作的联系人。
Data

包含一个 DataPackage 对象，其中包含用户想要共享的数据。
QuickLinkId

包含 QuickLink 的 ID 的字符串。

方法

DismissUI()

关闭共享窗格。
RemoveThisQuickLink()

从用户可用的 QuickLink 列表中删除 QuickLink。
ReportCompleted()

指定共享操作已完成。
ReportCompleted(QuickLink)

指定共享操作已完成。 包含一个 QuickLink，系统可以保存为将来共享操作的快捷方式。
ReportDataRetrieved()

指定应用已获取用户想要共享的内容。
ReportError(String)

指定在共享操作期间发生错误。
ReportStarted()

指定应用已开始获取用户想要共享的内容。
ReportSubmittedBackgroundTask()

指定应用已请求系统允许共享操作作为后台任务运行。

适用于

另请参阅