共用方式為

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 類別的實例。

目前以 Share 目標開啟的應用程式無法起始額外的 ShareOperation，或啟動 FileOpenPicker 或 FileSavePicker。

只有在啟用 Share 目標的 CoreWindow 之後，才應該呼叫所有 ShareOperation API。 共用平臺只會在啟用視窗之後，才建立共用作業的專案。

注意

這個類別不是敏捷的，這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱執行緒和封送處理 (C++/CX) 和在多執行緒環境中使用 Windows 執行階段 物件 (.NET) 。

版本歷程記錄

Windows 版本 SDK 版本 新增值
1709 16299 連絡人

屬性

Contacts

取得共用作業的連絡人。
Data

包含 DataPackage 物件，其中包含使用者想要共用的資料。
QuickLinkId

包含 QuickLink 識別碼的字串。

方法

DismissUI()

關閉共用窗格。
RemoveThisQuickLink()

從使用者可用的 QuickLinks 清單中移除 QuickLink。
ReportCompleted()

指定共用作業已完成。
ReportCompleted(QuickLink)

指定共用作業已完成。 系統可儲存為未來共用作業快捷方式的 QuickLink。
ReportDataRetrieved()

指定應用程式已取得使用者想要共用的內容。
ReportError(String)

指定共用作業期間發生錯誤。
ReportStarted()

指定應用程式已開始取得使用者想要共用的內容。
ReportSubmittedBackgroundTask()

指定應用程式要求系統允許共用作業以背景工作的形式執行。

適用於

另請參閱