DataPackageView Clase

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.DataTransfer
Editar

Una versión de solo lectura de un DataPackage. Las aplicaciones que reciben contenido compartido obtienen este objeto al adquirir contenido.

public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
Herencia
Object Platform::Object IInspectable DataPackageView
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

El código siguiente muestra cómo puede usar DataPackageView para obtener el texto que se comparte. Para que este ejemplo funcione correctamente, debe agregar código que detecte si la aplicación se inició en respuesta a una operación de uso compartido. Consulte nuestro tema Cómo recibir texto para obtener más información.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

Comentarios

Durante una operación de uso compartido, la aplicación de origen coloca los datos que se comparten en un objeto DataPackage y envía ese objeto a la aplicación de destino para su procesamiento. La clase DataPackage incluye varios métodos para admitir los siguientes formatos predeterminados: text, Rtf, Html, Bitmap y StorageItems. También tiene métodos para admitir formatos de datos personalizados. Para usar estos formatos, tanto la aplicación de origen como la aplicación de destino ya deben tener en cuenta que el formato personalizado existe.

Las aplicaciones de destino pueden usar el objeto DataPackageView para adquirir los datos que se comparten. Además, estas aplicaciones pueden usar la propiedad AvailableFormats para identificar qué formato admite DataPackageView o el método Contains para consultar un formato específico.

Las aplicaciones de origen tienen la opción de usar SetDataProvider para asignar un delegado a un DataPackage, en lugar de proporcionar los datos inmediatamente. Este proceso es útil en situaciones en las que la aplicación de origen admite un formato determinado, pero no quiere generar los datos a menos que la aplicación de destino lo solicite. Por ejemplo, una aplicación de origen podría admitir una variedad de formatos de imagen para compartir fotos. En lugar de crear varias copias de cada imagen con estos formatos, la aplicación de origen puede usar un delegado al que se llama cuando la aplicación de destino solicita un tipo de formato específico.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1511 10586 SetAcceptedFormatId

Propiedades

AvailableFormats

Devuelve los formatos que contiene DataPackageView .
Properties

Obtiene un objeto DataPackagePropertySetView , que contiene un conjunto de propiedades de solo lectura para los datos del objeto DataPackageView .
RequestedOperation

Obtiene la operación solicitada (como copiar o mover). Se usa principalmente para las acciones del Portapapeles.

Métodos

Contains(String)

Comprueba si DataPackageView contiene un formato de datos específico.
GetApplicationLinkAsync()

Obtiene el vínculo de la aplicación en el objeto DataPackageView .
GetBitmapAsync()

Obtiene la imagen de mapa de bits contenida en DataPackageView.
GetDataAsync(String)

Obtiene los datos contenidos en DataPackageView.
GetHtmlFormatAsync()

Obtiene el código HTML almacenado en el objeto DataPackageView .
GetResourceMapAsync()

Obtiene los datos (como una imagen) a los que se hace referencia en el contenido HTML.
GetRtfAsync()

Obtiene el contenido con formato de texto enriquecido (RTF) contenido contenido en dataPackageView.
GetStorageItemsAsync()

Obtiene los archivos y carpetas almacenados en un objeto DataPackageView .
GetTextAsync()

Obtiene el texto del objeto DataPackageView .
GetTextAsync(String)

Obtiene el texto del objeto DataPackageView .
GetUriAsync()

Nota:

GetUriAsync puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetApplicationLink o GetWebLink.

Obtiene el URI contenido en DataPackageView.
GetWebLinkAsync()

Obtiene el vínculo web en el objeto DataPackageView .
ReportOperationCompleted(DataPackageOperation)

Informa al sistema de que la aplicación ha terminado de usar el objeto DataPackageView . Se usa principalmente para las operaciones del Portapapeles.
RequestAccessAsync()

Solicita permiso para desbloquear y acceder a un paquete de datos protegido con una directiva de protección.
RequestAccessAsync(String)

Solicita permiso para desbloquear y acceder a un paquete de datos protegido con una directiva de protección.
SetAcceptedFormatId(String)

Establece el identificador de formato aceptado.
UnlockAndAssumeEnterpriseIdentity()

Desbloquea un paquete de datos y asume una identidad empresarial para él.

Se aplica a

Consulte también