Partilhar via


ShareOperation Classe

Definição

Manipula a maior parte do trabalho durante uma operação de compartilhamento. Isso inclui os dados que o usuário deseja compartilhar, definir ou remover QuickLinks e informar o sistema sobre o status da operação.

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
Herança
Object Platform::Object IInspectable ShareOperation
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como trabalhar com o objeto 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);
        }
    });
}

Comentários

Quando um usuário seleciona seu aplicativo como o destino de uma ação de compartilhamento, um evento ativado é acionado . O objeto que esse evento envia para seu aplicativo contém a instância da classe ShareOperation .

No momento, um aplicativo aberto como um destino de compartilhamento não pode iniciar uma ShareOperation adicional ou iniciar um FileOpenPicker ou FileSavePicker.

Todas as APIs do ShareOperation só devem ser chamadas depois que o CoreWindow para o destino Compartilhamento for ativado. A plataforma Compartilhar cria uma entrada para a operação de compartilhamento somente após a janela ter sido ativada.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1.709 16299 Contatos

Propriedades

Contacts

Obtém os contatos para a operação de compartilhamento.

Data

Contém um objeto DataPackage com os dados que o usuário deseja compartilhar.

QuickLinkId

Uma cadeia de caracteres que contém a ID de um QuickLink.

Métodos

DismissUI()

Fecha o painel de compartilhamento.

RemoveThisQuickLink()

Remove o QuickLink da lista de QuickLinks que estão disponíveis para o usuário.

ReportCompleted()

Especifica que a operação de compartilhamento está concluída.

ReportCompleted(QuickLink)

Especifica que a operação de compartilhamento está concluída. Um QuickLink que o sistema pode salvar como um atalho para futuras operações de compartilhamento está incluído.

ReportDataRetrieved()

Especifica que o aplicativo adquiriu o conteúdo que o usuário deseja compartilhar.

ReportError(String)

Especifica que ocorreu um erro durante a operação de compartilhamento.

ReportStarted()

Especifica que o aplicativo começou a adquirir o conteúdo que o usuário deseja compartilhar.

ReportSubmittedBackgroundTask()

Especifica que o aplicativo solicitou que o sistema permitisse que a operação de compartilhamento seja executada como uma tarefa em segundo plano.

Aplica-se a

Confira também