StandardDataFormats Classe

Définition

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

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.

S’applique à