StandardDataFormats Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Contiene proprietà statiche che restituiscono valori stringa. Ogni stringa corrisponde a un ID di formato noto. Utilizzare questa classe per evitare errori nell'uso di costanti stringa per specificare i formati di dati.

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

Ereditarietà

Object Platform::Object IInspectable StandardDataFormats

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato come recuperare testo condiviso (usando StandardDataFormats.Text) o un file o una cartella condivisa (tramite StandardDataFormats.StorageItems). Per altri esempi, vedere l'esempio degli Appunti e l'esempio 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();
}

Commenti

La classe DataPackage supporta diversi tipi di formato. Ogni volta che è necessario specificare un formato, è consigliabile usare le proprietà della classe StandardDataFormats anziché i valori stringa. In questo modo si garantisce la coerenza tra le applicazioni di origine e di destinazione.

La classe DataPackage supporta diversi formati legacy per l'interoperabilità tra app UWP e app desktop. Per recuperare questi formati, passare una delle stringhe seguenti al metodo DataPackageView.GetDataAsync anziché un valore dalla classe StandardDataFormats .

Se il nome del formato è:	GetDataAsync() recupera:
"AnsiText"	Stringa per CF_TEXT.
"DeviceIndependentBitmap"	Flusso per HGLOBAL corrispondente a CF_DIB.
"DeviceIndependentBitmapV5"	Flusso per HGLOBAL corrispondente a CF_DIBV5.
"DataInterchangeFormat"	Flusso per HGLOBAL corrispondente a CF_DIF.
"EnhancedMetafile"	Flusso per HENHMETAFILE corrispondente a CF_ENHMETAFILE.
"Impostazioni locali"	Flusso per HGLOBAL corrispondente a CF_LOCALE
"OEMText"	Stringa per CF_OEMTEXT.
"PenData"	Flusso per HGLOBAL corrispondente a CF_PENDATA
"RiffAudio"	Flusso per HGLOBAL corrispondente a CF_RIFF.
"SymbolicLink"	Flusso per HGLOBAL corrispondente a CF_SYLK.
"TaggedImageFileFormat"	Flusso per HGLOBAL corrispondente a CF_TIFF.
"WaveAudio"	Flusso per HGLOBAL corrispondente a CF_WAVE.

Il Windows Runtime offre un supporto limitato per i metafile. In particolare, il Windows Runtime:

• Supporta il rendering dei metafile, ma non li crea.
• Supporta il formato CF_ENHMETAFILE ("EnhancedMetafile"), ma non CF_METAFILEPICT.
• Supporta la richiesta di dati in formato "EnhancedMetafile", ma non la specifica; cioè, la chiamata SetData("EnhancedMetafile", <data>) non funzionerà.
• Fornisce supporto limitato tramite l'API Degli Appunti per lo scambio di metafile tra app UWP e app desktop.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1803	17134	UserActivityJsonArray

Proprietà

ApplicationLink	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato del collegamento di attivazione.
Bitmap	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato Bitmap.
Html	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato HTML.
Rtf	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato RTF (Rich Text Format).
StorageItems	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato dell'elemento di archiviazione (per file e cartelle).
Text	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato Text.
Uri	Nota L'URI può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece ApplicationLink o WebLink. Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato URI (Uniform Resource Identifier).
UserActivityJsonArray	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato della matrice JSON UserActivity .
WebLink	Proprietà di sola lettura che restituisce il valore della stringa ID di formato corrispondente al formato del collegamento Web.