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) アプリ用です。 デスクトップ アプリに使用する代替 API については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
ShowShareUI(ShareUIOptions)	プログラムによって、コンテンツを別のアプリと共有するためのユーザー インターフェイスを開始します。 この API は、ユニバーサル Windows プラットフォーム (UWP) アプリ用です。 デスクトップ アプリに使用する代替 API については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

イベント

DataRequested	共有操作の開始時に発生します。
ShareProvidersRequested	共有プロバイダーが要求されたときにトリガーされるイベント。 これはコールバックとして使用され、プロバイダーは、このイベントをサブスクライブし、イベント ハンドラーで ShareProvidersRequestedEventArgs.Providers.Add() を呼び出すことによって追加されます。
TargetApplicationChosen	ユーザーが共有 UI でターゲット アプリを選択したときに発生します。

こちらもご覧ください

• コンテンツ ソース アプリの共有のサンプル (Windows 10)