Compartir a través de

StandardDataFormats Clase

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.DataTransfer
Editar

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.

Se aplica a