StandardDataFormats Classe

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Contém propriedades estáticas que retornam valores de cadeia de caracteres. Cada cadeia de caracteres corresponde a uma ID de formato conhecida. Use essa classe para evitar erros ao usar constantes de cadeia de caracteres para especificar formatos de dados.

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

Herança

Object Platform::Object IInspectable StandardDataFormats

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo mostra como recuperar texto compartilhado (usando StandardDataFormats.Text) ou um arquivo ou pasta compartilhado (usando StandardDataFormats.StorageItems). Para obter mais exemplos, consulte o exemplo área de transferência e o exemplo do 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();
}

Comentários

A classe DataPackage dá suporte a vários tipos de formato. Sempre que você precisar especificar um formato, recomendamos usar as propriedades da classe StandardDataFormats , em vez de valores de cadeia de caracteres. Isso garante a consistência entre aplicativos de origem e de destino.

A classe DataPackage dá suporte a vários formatos herdados para interoperabilidade entre aplicativos UWP e aplicativos da área de trabalho. Para recuperar esses formatos, você passa uma das seguintes cadeias de caracteres para o método DataPackageView.GetDataAsync em vez de um valor da classe StandardDataFormats .

Se o nome do formato for:	GetDataAsync() recupera:
"AnsiText"	Cadeia de caracteres para CF_TEXT.
"DeviceIndependentBitmap"	Fluxo para HGLOBAL correspondente a CF_DIB.
"DeviceIndependentBitmapV5"	Fluxo para HGLOBAL correspondente a CF_DIBV5.
"DataInterchangeFormat"	Fluxo para HGLOBAL correspondente a CF_DIF.
"EnhancedMetafile"	Fluxo para HENHMETAFILE correspondente a CF_ENHMETAFILE.
"Localidade"	Fluxo para HGLOBAL correspondente a CF_LOCALE
"OEMText"	Cadeia de caracteres para CF_OEMTEXT.
"PenData"	Fluxo para HGLOBAL correspondente a CF_PENDATA
"RiffAudio"	Fluxo para HGLOBAL correspondente a CF_RIFF.
"SymbolicLink"	Fluxo para HGLOBAL correspondente a CF_SYLK.
"TaggedImageFileFormat"	Fluxo para HGLOBAL correspondente a CF_TIFF.
"WaveAudio"	Fluxo para HGLOBAL correspondente a CF_WAVE.

O Windows Runtime fornece suporte limitado para metarquivos. Especificamente, o Windows Runtime:

• Dá suporte à renderização de metafiles, mas não à criação deles.
• Dá suporte ao formato CF_ENHMETAFILE ("EnhancedMetafile"), mas não CF_METAFILEPICT.
• Dá suporte à solicitação de dados no formato "EnhancedMetafile", mas não o fornece; Ou seja, chamar SetData("EnhancedMetafile", <data>) não funcionará.
• Fornece suporte limitado por meio da API da área de transferência para trocar metarquivos entre aplicativos UWP e aplicativos da área de trabalho.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1803	17134	UserActivityJsonArray

Propriedades

ApplicationLink	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato de link de ativação.
Bitmap	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato Bitmap.
Html	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato HTML.
Rtf	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao RTF (Rich Text Format).
StorageItems	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato do item de armazenamento (para arquivos e pastas).
Text	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato Text.
Uri	Observação Uri pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use ApplicationLink ou WebLink. Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato URI (Uniform Resource Identifier).
UserActivityJsonArray	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato de matriz JSON UserActivity .
WebLink	Uma propriedade somente leitura que retorna o valor da cadeia de caracteres de ID de formato correspondente ao formato de link da Web.