Idioma: HTML | XAML

Como compartilhar um link (XAML)

Applies to Windows and Windows Phone

Links são outro formato comum de dados que os usuários gostam de compartilhar. A razão mais comum para compartilhar um link é quando um usuário seleciona um especificamente. No entanto, recomendamos também que o aplicativo ofereça suporte ao compartilhamento de links:

  • Quando o conteúdo selecionado pelo usuário também está disponível online.
  • Como uma fonte secundária ao compartilhar HTML.

Observação  

Os links também podem ser compartilhados usando Tocar e enviar. Tocar e enviar é compartilhado por meio da comunicação a curta distância (NFC).

O que você precisa saber

Tecnologias

Pré-requisitos

  • Você deve estar familiarizado com o Visual Studio e seus modelos.
  • Você deve estar familiarizado com desenvolvimento em C#/C++.

Instruções

Etapa 1: Adicionar o namespace DataTransfer

Você deve adicionar os namespaces corretos ao seu aplicativo para que você possa criar e processar os objetos relacionados ao compartilhamento. Você deve adicionar, pelo menos, o namespace Windows.ApplicationModel.DataTransfer:


using Windows.ApplicationModel.DataTransfer;


Esse namespace tem tudo o que você precisa para compartilhamento básico. Lembre-se, contudo, de que se você quiser compartilhar conteúdo como imagens ou arquivos, precisará adicionar esses namespaces também. Veja uma lista dos namespaces de que você pode precisar:

Etapa 2: Obter o objeto DataTransferManager

O objeto DataTransferManager é o ponto de partida de qualquer operação de compartilhamento.


DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();


Etapa 3: Adicionar um manipulador de eventos para o evento DataRequested

Adicione um manipulador de eventos DataRequested para disparar quando o usuário desejar chamar a opção Compartilhar. Em um aplicativo da Windows Store, isso ocorre automaticamente quando o usuário chamar o botão Compartilhar. Se estiver desenvolvendo para Windows Phone, não haverá botão Compartilhar interno, portanto você precisará adicionar um controle para o usuário tocar e disparar o manipulador.


dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, 
    DataRequestedEventArgs>(this.ShareLinkHandler);

Etapa 4: Obter um objeto DataRequest

Quando ocorre um evento DataRequested, o seu aplicativo recebe um objeto DataRequest. Este objeto contém um DataPackage que você pode usar para fornecer o conteúdo que o usuário quer compartilhar.


DataRequest request = e.Request;


Etapa 5: Definir as propriedades de título e descrição

A propriedade de título é obrigatória e deve ser definida.


// The title is mandatory
request.Data.Properties.Title = "Share Link Example";
request.Data.Properties.Description = "Demonstrates how to add a link to share.";

Etapa 6: Adicionar o link ao DataPackage

Para adicionar o link, use o método SetWebLink.


request.Data.SetWebLink(new Uri("http://www.fabrikam.com"));

Exemplo completo

Aqui está um exemplo de uma função que define um link do usuário para compartilhamento. Para obter um exemplo mais complexo, consulte a nossa amostra da galeria de código.


private void RegisterForShare()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, 
        DataRequestedEventArgs>(this.ShareLinkHandler);
}

private void ShareLinkHandler(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Link Example";
    request.Data.Properties.Description = "Demonstrates how to add a link to share.";
    request.Data.SetWebLink(new Uri("http://www.fabrikam.com"));
}

Tópicos relacionados

Exemplo de aplicativo de compartilhamento de origem de conteúdo
Compartilhando e trocando dados
Como compartilhar arquivos
Como compartilhar HTML
Como compartilhar texto
Início rápido: compartilhando conteúdo
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Mostrar:
© 2014 Microsoft