StandardDataFormats Classe

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Contient des propriétés statiques qui retournent des valeurs de chaîne. Chaque chaîne correspond à un ID de format connu. Utilisez cette classe pour éviter les erreurs d’utilisation de constantes de chaîne pour spécifier des formats de données.

public ref class StandardDataFormats abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StandardDataFormats final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class StandardDataFormats

Public Class StandardDataFormats

Héritage

Object Platform::Object IInspectable StandardDataFormats

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

Cet exemple montre comment récupérer du texte partagé (à l’aide de StandardDataFormats.Text) ou un fichier ou dossier partagé (à l’aide de StandardDataFormats.StorageItems). Pour plus d’exemples, consultez l’exemple de Presse-papiers et l’exemple ShareTarget.

public async Task ActivateAsync(ShareTargetActivatedEventArgs args)
{
    ShareOperation shareOperation = args.ShareOperation;
    if (shareOperation.Data.Contains(StandardDataFormats.Text))
    {
        string text = await shareOperation.Data.GetTextAsync();

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text = "Text: " + text;
    }

    if (shareOperation.Data.Contains(StandardDataFormats.StorageItems)) 
    {
        shareOperation.ReportStarted();
        IReadOnlyList<IStorageItem> storageItems = null;
        storageItems = await shareOperation.Data.GetStorageItemsAsync();
        string fileList = String.Empty;

        for (int index = 0; index < storageItems.Count; index++) 
        {
            fileList += storageItems[index].Name;
                if (index < storageItems.Count - 1) {
                    fileList += ", ";
                }
            }

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text += "StorageItems: " + fileList + Environment.NewLine;

        shareOperation.ReportCompleted();
    }

    Window.Current.Content = this;
    Window.Current.Activate();
}

Remarques

La classe DataPackage prend en charge plusieurs types de format. Chaque fois que vous devez spécifier un format, nous vous recommandons d’utiliser les propriétés de la classe StandardDataFormats au lieu de valeurs de chaîne. Cela garantit la cohérence entre les applications sources et cibles.

La classe DataPackage prend en charge un certain nombre de formats hérités pour l’interopérabilité entre l’application UWP et les applications de bureau. Pour récupérer ces formats, vous transmettez l’une des chaînes suivantes à la méthode DataPackageView.GetDataAsync au lieu d’une valeur de la classe StandardDataFormats .

Si le nom du format est :	GetDataAsync() récupère :
« AnsiText »	Chaîne pour CF_TEXT.
« DeviceIndependentBitmap »	Flux pour HGLOBAL correspondant à CF_DIB.
« DeviceIndependentBitmapV5 »	Flux pour HGLOBAL correspondant à CF_DIBV5.
« DataInterchangeFormat »	Flux pour HGLOBAL correspondant à CF_DIF.
« EnhancedMetafile »	Flux pour HENHMETAFILE correspondant à CF_ENHMETAFILE.
« Paramètres régionaux »	Flux pour HGLOBAL correspondant à CF_LOCALE
« OEMText »	Chaîne pour CF_OEMTEXT.
« PenData »	Flux pour HGLOBAL correspondant à CF_PENDATA
« RiffAudio »	Flux pour HGLOBAL correspondant à CF_RIFF.
« SymbolicLink »	Flux pour HGLOBAL correspondant à CF_SYLK.
« TaggedImageFileFormat »	Flux pour HGLOBAL correspondant à CF_TIFF.
« WaveAudio »	Flux pour HGLOBAL correspondant à CF_WAVE.

Le Windows Runtime offre une prise en charge limitée des métafichiers. Plus précisément, les Windows Runtime :

• Prend en charge le rendu des métafichiers, mais pas leur création.
• Prend en charge le format CF_ENHMETAFILE (« EnhancedMetafile »), mais pas CF_METAFILEPICT.
• Prend en charge la demande de données au format « EnhancedMetafile », mais ne les fournit pas ; c’est-à-dire qu’appeler SetData("EnhancedMetafile", <data>) ne fonctionne pas.
• Fournit une prise en charge limitée via l’API du Presse-papiers pour l’échange de métafichiers entre l’application UWP et les applications de bureau.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1803	17134	UserActivityJsonArray

Propriétés

ApplicationLink	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format de lien d’activation.
Bitmap	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format Bitmap.
Html	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format HTML.
Rtf	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format RTF (Rich Text Format).
StorageItems	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format d’élément de stockage (pour les fichiers et dossiers).
Text	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format Texte.
Uri	Notes L’URI peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt ApplicationLink ou WebLink. Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format URI (Uniform Resource Identifier).
UserActivityJsonArray	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format de tableau JSON UserActivity .
WebLink	Propriété en lecture seule qui renvoie la valeur de chaîne d’ID de format correspondant au format de lien web.