共用方式為


DataTransferManager 類別

定義

以程式設計方式起始與其他應用程式的內容交換。

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
屬性

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) 應用程式。 在 顯示相依于 CoreWindow 的 WinRT UI 物件中,會說明傳統型應用程式的替代 API。

ShowShareUI(ShareUIOptions)

以程式設計方式起始使用者介面,以便與另一個應用程式共用內容。

此 API 適用于 通用 Windows 平臺 (UWP) 應用程式。 在 顯示相依于 CoreWindow 的 WinRT UI 物件中,會說明傳統型應用程式的替代 API。

事件

DataRequested

發生于共用作業啟動時。

ShareProvidersRequested

要求共用提供者時所觸發的事件。 這會用來作為回呼,而且會在事件處理常式中訂閱此事件並呼叫 ShareProvidersRequestedEventArgs.Providers.Add () 來新增。

TargetApplicationChosen

發生于使用者在共用 UI 中選擇目標應用程式時。

適用於

另請參閱