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 개체를 반환합니다. 다음으로, 데이터 요청 이벤트에 대한 이벤트 수신기를 개체에 추가해야 합니다. 이 이벤트는 공유 작업이 시작될 때 발생합니다. 일반적으로 사용자가 공유 참을 탭할 때 발생하지만 앱이 프로그래밍 방식으로 공유 작업을 시작하는 경우에도 발생합니다.

DataTransferManager 클래스에는 프로그래밍 방식으로 공유 작업을 시작하는 데 사용할 수 있는 ShowShareUI 메서드가 포함되어 있습니다.

DataTransferManager 클래스에는 TargetApplicationChosen 이벤트도 있습니다. 앱에서 콘텐츠를 공유할 때 사용자가 선택하는 애플리케이션을 캡처하려는 경우 이 이벤트를 사용합니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용을 참조하세요.

Windows Phone 8

이 API는 네이티브 앱에서만 지원됩니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	Issupported
1703	15063	ShareProvidersRequested
1709	16299	ShowShareUI(ShareUIOptions)

메서드

GetForCurrentView()	현재 창과 연결된 DataTransferManager 개체를 반환합니다.
IsSupported()	디바이스에서 공유를 지원하는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.
ShowShareUI()	프로그래밍 방식으로 다른 앱과 콘텐츠를 공유하기 위한 사용자 인터페이스를 시작합니다. 이 API는 UWP(유니버설 Windows 플랫폼) 앱용입니다. 데스크톱 앱에 사용할 대체 API는 CoreWindow에 의존하는 Display WinRT UI 개체에 설명되어 있습니다.
ShowShareUI(ShareUIOptions)	프로그래밍 방식으로 다른 앱과 콘텐츠를 공유하기 위한 사용자 인터페이스를 시작합니다. 이 API는 UWP(유니버설 Windows 플랫폼) 앱용입니다. 데스크톱 앱에 사용할 대체 API는 CoreWindow에 의존하는 Display WinRT UI 개체에 설명되어 있습니다.

이벤트

DataRequested	공유 작업이 시작될 때 발생합니다.
ShareProvidersRequested	공유 공급자가 요청될 때 트리거되는 이벤트입니다. 이는 콜백으로 사용되며 공급자는 이 이벤트를 구독하고 이벤트 처리기에서 ShareProvidersRequestedEventArgs.Providers.Add()를 호출하여 추가됩니다.
TargetApplicationChosen	사용자가 공유 UI에서 대상 앱을 선택할 때 발생합니다.

추가 정보

• 콘텐츠 원본 앱 공유 샘플(Windows 10)