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 需求

裝置系列	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 中選擇目標應用程式時。

另請參閱

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