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)]
/// [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)]
[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 需求

規格需求	Description
裝置系列	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)

方法

名稱	Description
GetForCurrentView()	會傳回與目前視窗相關聯的 DataTransferManager 物件。
IsSupported()	如果裝置支援共用，則傳回 true，否則傳回 false。
ShowShareUI()	以程式設計方式起始使用者介面，以便與另一個應用程式共用內容。 此 API 適用于 通用 Windows 平臺 (UWP) 應用程式。 在 顯示相依于 CoreWindow 的 WinRT UI 物件中，會說明傳統型應用程式的替代 API。
ShowShareUI(ShareUIOptions)	以程式設計方式起始使用者介面，以便與另一個應用程式共用內容。 此 API 適用于 通用 Windows 平臺 (UWP) 應用程式。 在 顯示相依于 CoreWindow 的 WinRT UI 物件中，會說明傳統型應用程式的替代 API。

事件

名稱	Description
DataRequested	發生于共用作業啟動時。
ShareProvidersRequested	要求共用提供者時所觸發的事件。 這會用來作為回呼，而且會在事件處理常式中訂閱此事件並呼叫 ShareProvidersRequestedEventArgs.Providers.Add () 來新增。
TargetApplicationChosen	發生于使用者在共用 UI 中選擇目標應用程式時。

另請參閱

• 共用內容來源應用程式範例 (Windows 10)