StandardDataFormats Classe

Definizione

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

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 .

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

Proprietà

Si applica a