DataPackageView Classe

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.DataTransfer
Modifier

Version en lecture seule d’un DataPackage. Les applications qui reçoivent du contenu partagé obtiennent cet objet lors de l’acquisition de contenu.

public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
Héritage
Object Platform::Object IInspectable DataPackageView
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Le code suivant montre comment utiliser DataPackageView pour obtenir le texte partagé. Pour que cet exemple fonctionne correctement, vous devez ajouter du code qui détecte si votre application a été lancée en réponse à une opération de partage. Consultez notre rubrique Comment recevoir du texte pour en savoir plus.

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

Remarques

Pendant une opération de partage, l’application source place les données partagées dans un objet DataPackage et envoie cet objet à l’application cible pour traitement. La classe DataPackage comprend un certain nombre de méthodes pour prendre en charge les formats par défaut suivants : text, Rtf, Html, Bitmap et StorageItems. Il a également des méthodes pour prendre en charge les formats de données personnalisés. Pour utiliser ces formats, l’application source et l’application cible doivent déjà savoir que le format personnalisé existe.

Les applications cibles peuvent utiliser l’objet DataPackageView pour acquérir les données partagées. En outre, ces applications peuvent utiliser la propriété AvailableFormats pour identifier les formats pris en charge par DataPackageView ou la méthode Contains pour interroger un format spécifique.

Les applications sources ont la possibilité d’utiliser SetDataProvider pour affecter un délégué à un DataPackage, au lieu de fournir les données immédiatement. Ce processus est utile dans les situations où l’application source prend en charge un format donné, mais ne souhaite pas générer les données, sauf si l’application cible le demande. Par exemple, une application source peut prendre en charge divers formats d’image pour le partage de photos. Au lieu de créer plusieurs copies de chaque image à l’aide de ces formats, l’application source peut utiliser un délégué appelé lorsque l’application cible demande un type de format spécifique.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1511 10586 SetAcceptedFormatId

Propriétés

AvailableFormats

Retourne les formats que contient DataPackageView .
Properties

Obtient un objet DataPackagePropertySetView , qui contient un ensemble de propriétés en lecture seule pour les données de l’objet DataPackageView .
RequestedOperation

Obtient l’opération demandée (telle que la copie ou le déplacement). Principalement utilisé pour les actions du Presse-papiers.

Méthodes

Contains(String)

Vérifie si DataPackageView contient un format de données spécifique.
GetApplicationLinkAsync()

Obtient le lien d’application dans l’objet DataPackageView .
GetBitmapAsync()

Obtient l’image bitmap contenue dans DataPackageView
GetDataAsync(String)

Obtient les données contenues dans dataPackageView.
GetHtmlFormatAsync()

Obtient le code HTML stocké dans l’objet DataPackageView .
GetResourceMapAsync()

Obtient les données (telles qu’une image) référencées dans le contenu HTML.
GetRtfAsync()

Obtient le contenu RTF (Rich Text Formatted) contenu dans un DataPackageView.
GetStorageItemsAsync()

Obtient les fichiers et dossiers stockés dans un objet DataPackageView .
GetTextAsync()

Obtient le texte dans l’objet DataPackageView .
GetTextAsync(String)

Obtient le texte dans l’objet DataPackageView .
GetUriAsync()

Notes

GetUriAsync peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetApplicationLink ou GetWebLink.

Obtient l’URI contenu dans le DataPackageView.
GetWebLinkAsync()

Obtient le lien web dans l’objet DataPackageView .
ReportOperationCompleted(DataPackageOperation)

Informe le système que votre application a terminé d’utiliser l’objet DataPackageView . Principalement utilisé pour les opérations du Presse-papiers.
RequestAccessAsync()

Demande l’autorisation de déverrouiller et d’accéder à un package de données sécurisé avec une stratégie de protection.
RequestAccessAsync(String)

Demande l’autorisation de déverrouiller et d’accéder à un package de données sécurisé avec une stratégie de protection.
SetAcceptedFormatId(String)

Définit l’ID de format accepté.
UnlockAndAssumeEnterpriseIdentity()

Déverrouille un package de données et suppose une identité d’entreprise pour celui-ci.

S’applique à

Voir aussi