다음을 통해 공유

ShareOperation 클래스

  • 참조

정의

네임스페이스:
Windows.ApplicationModel.DataTransfer.ShareTarget
편집

공유 작업 중에 작업의 대부분을 처리합니다. 여기에는 사용자가 공유하려는 데이터, QuickLinks 설정 또는 제거, 작업 상태 대한 시스템 알림이 포함됩니다.

public ref class ShareOperation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation
Public NotInheritable Class ShareOperation
상속
Object Platform::Object IInspectable ShareOperation
특성
ContractVersionAttribute MarshalingBehaviorAttribute

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에서 도입되었습니다.)

예제

다음 예제에서는 ShareOperation 개체로 작업하는 방법을 보여줍니다.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

설명

사용자가 공유 작업의 대상으로 앱을 선택하면 활성화된 이벤트가 발생합니다. 이 이벤트가 앱에 보내는 개체에는 ShareOperation 클래스의 instance 포함됩니다.

현재 공유 대상으로 열려 있는 앱은 추가 ShareOperation을 시작하거나 FileOpenPicker 또는 FileSavePicker를 시작할 수 없습니다.

모든 ShareOperation API는 공유 대상의 CoreWindow가 활성화된 후에만 호출되어야 합니다. 공유 플랫폼은 창이 활성화된 후에만 공유 작업에 대한 항목을 만듭니다.

참고

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

버전 기록

Windows 버전 SDK 버전 추가된 값
1709 16299 연락처

속성

Contacts

공유 작업의 연락처를 가져옵니다.
Data

사용자가 공유하려는 데이터가 포함된 DataPackage 개체를 포함합니다.
QuickLinkId

QuickLink의 ID를 포함하는 문자열입니다.

메서드

DismissUI()

공유 창을 닫습니다.
RemoveThisQuickLink()

사용자가 사용할 수 있는 QuickLink 목록에서 QuickLink를 제거합니다.
ReportCompleted()

공유 작업이 완료되도록 지정합니다.
ReportCompleted(QuickLink)

공유 작업이 완료되도록 지정합니다. 시스템이 향후 공유 작업을 위한 바로 가기로 저장할 수 있는 QuickLink가 포함되어 있습니다.
ReportDataRetrieved()

앱이 사용자가 공유하려는 콘텐츠를 획득하도록 지정합니다.
ReportError(String)

공유 작업 중에 오류가 발생했음을 지정합니다.
ReportStarted()

앱이 사용자가 공유하려는 콘텐츠를 획득하기 시작했음을 지정합니다.
ReportSubmittedBackgroundTask()

앱이 시스템에서 공유 작업을 백그라운드 작업으로 실행할 수 있도록 요청했음을 지정합니다.

적용 대상

추가 정보