Partilhar via

StandardDataFormats Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.DataTransfer
Editar

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.

Aplica-se a