StandardDataFormats Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

Contiene propiedades estáticas que devuelven valores de cadena. Cada cadena corresponde a un identificador de formato conocido. Use esta clase para evitar errores en el uso de constantes de cadena para especificar formatos de datos.

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

Herencia

Object Platform::Object IInspectable StandardDataFormats

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra cómo recuperar texto compartido (mediante StandardDataFormats.Text) o un archivo o carpeta compartidos (mediante StandardDataFormats.StorageItems). Para obtener más ejemplos, consulte el ejemplo del Portapapeles y el ejemplo 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();
}

Comentarios

La clase DataPackage admite varios tipos de formato. Siempre que necesite especificar un formato, se recomienda usar las propiedades de la clase StandardDataFormats , en lugar de valores de cadena. Esto garantiza la coherencia entre las aplicaciones de origen y de destino.

La clase DataPackage admite una serie de formatos heredados para la interoperabilidad entre aplicaciones para UWP y aplicaciones de escritorio. Para recuperar estos formatos, se pasa una de las siguientes cadenas al método DataPackageView.GetDataAsync en lugar de un valor de la clase StandardDataFormats .

Si el nombre del formato es:	GetDataAsync() recupera:
"AnsiText"	Cadena para CF_TEXT.
"DeviceIndependentBitmap"	Stream for HGLOBAL correspondiente a CF_DIB.
"DeviceIndependentBitmapV5"	Stream for HGLOBAL correspondiente a CF_DIBV5.
"DataInterchangeFormat"	Stream for HGLOBAL correspondiente a CF_DIF.
"EnhancedMetafile"	Secuencia de HENHMETAFILE correspondiente a CF_ENHMETAFILE.
"Configuración regional"	Stream for HGLOBAL correspondiente a CF_LOCALE
"OEMText"	Cadena para CF_OEMTEXT.
"PenData"	Stream for HGLOBAL correspondiente a CF_PENDATA
"RiffAudio"	Stream for HGLOBAL correspondiente a CF_RIFF.
"SymbolicLink"	Stream for HGLOBAL correspondiente a CF_SYLK.
"TaggedImageFileFormat"	Stream for HGLOBAL correspondiente a CF_TIFF.
"WaveAudio"	Stream for HGLOBAL correspondiente a CF_WAVE.

El Windows Runtime proporciona compatibilidad limitada con metarchivos. En concreto, el Windows Runtime:

• Admite la representación de metarchivos, pero no crearlos.
• Admite el formato CF_ENHMETAFILE ("EnhancedMetafile"), pero no CF_METAFILEPICT.
• Admite la solicitud de datos en formato "EnhancedMetafile", pero no proporcionándolo; Es decir, llamar SetData("EnhancedMetafile", <data>) a no funcionará.
• Proporciona compatibilidad limitada a través de la API del Portapapeles para intercambiar metarchivos entre aplicaciones para UWP y aplicaciones de escritorio.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1803	17134	UserActivityJsonArray

Propiedades

ApplicationLink	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato del vínculo de activación.
Bitmap	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato de mapa de bits.
Html	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato HTML.
Rtf	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato de texto enriquecido (RTF).
StorageItems	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato del elemento de almacenamiento (para archivos y carpetas).
Text	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato Text.
Uri	Nota El URI puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use ApplicationLink o WebLink. Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato URI (Identificador uniforme de recursos).
UserActivityJsonArray	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato de matriz JSON UserActivity .
WebLink	Propiedad de solo lectura que devuelve el valor de cadena de identificador de formato correspondiente al formato de vínculo web.