Langage: HTML | XAML

Comment partager un lien (XAML)

Applies to Windows and Windows Phone

Les liens sont un autre format de données courant que les utilisateurs aiment partager. Le partage d’un lien intervient principalement en réponse à la sélection d’un lien spécifique par un utilisateur. Toutefois, nous recommandons que votre application prenne aussi en charge le partage des liens :

  • lorsque le contenu sélectionné par l’utilisateur est également disponible en ligne ;
  • en tant que deuxième source lors du partage de contenu HTML.

Remarque  

Vous pouvez également partager des liens à l’aide de la fonction Toucher et envoyer. La fonctionnalité Toucher et envoyer consiste à partager des éléments via la communication en champ proche (NFC).

Ce que vous devez savoir

Technologies

Prérequis

  • Vous devez être familiarisé avec Visual Studio et ses modèles.
  • Vous devez être familiarisé avec le développement en C#/C++.

Instructions

Étape 1: ajouter l’espace de noms DataTransfer

Vous devez ajouter les espaces de noms appropriés à votre application afin de pouvoir créer et traiter les objets associés au partage. Vous devez ajouter au minimum l’espace de noms Windows.ApplicationModel.DataTransfer :


using Windows.ApplicationModel.DataTransfer;


Cet espace de noms comporte tous les éléments nécessaires pour le partage de base. Gardez cependant à l’esprit que, si vous voulez partager un contenu tel que des images ou fichiers, vous devez également ajouter ces espaces de noms. Voici une liste des espaces de noms dont vous pouvez avoir besoin :

Étape 2: Obtenir l’objet DataTransferManager

L’objet DataTransferManager est le point de départ de toute opération de partage.


DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();


Étape 3: ajouter un gestionnaire d’événements pour l’événement DataRequested

Ajoutez un gestionnaire d’événements DataRequested qui se déclenche quand l’utilisateur souhaite appeler le partage. Dans une application du Windows Store, cela se produit automatiquement quand l’utilisateur appelle l’icône Partager. Si vous développez une application pour Windows Phone, aucune icône Partager n’est intégrée, donc vous devez ajouter un contrôle sur lequel l’utilisateur peut appuyer pour déclencher le gestionnaire.


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

Étape 4: obtenir un objet DataRequest

Lorsqu’un événement DataRequested survient, votre application reçoit un objet DataRequest. Cet objet contient une classe DataPackage que vous pouvez utiliser pour fournir le contenu qu’un utilisateur souhaite partager.


DataRequest request = e.Request;


Étape 5: Définir les propriétés de titre et de description

La propriété title est obligatoire et doit être définie.


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

Étape 6: ajouter le lien à l’objet DataPackage

Pour ajouter le lien, utilisez la méthode SetWebLink.


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

Exemple complet

Voici un exemple d’une fonction qui définit un lien qu’un utilisateur souhaite partager. Pour obtenir un exemple plus complet, voir l’exemple de notre bibliothèque de code.


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"));
}

Rubriques associées

Exemple de partage de contenu source entre applications
Partage et échange de données
Comment partager des fichiers
Comment partager du contenu HTML
Comment partager du texte
Démarrage rapide : partage de contenu
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Afficher:
© 2014 Microsoft