Partilhar via

DataPackageView Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.DataTransfer
Editar

Uma versão somente leitura de um DataPackage. Os aplicativos que recebem conteúdo compartilhado obtêm esse objeto ao adquirir conteúdo.

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
Herança
Object Platform::Object IInspectable DataPackageView
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

O código a seguir mostra como você pode usar o DataPackageView para obter o texto que está sendo compartilhado. Para que este exemplo funcione corretamente, você precisa adicionar código que detecta se o aplicativo foi iniciado em resposta a uma operação de compartilhamento. Confira nosso tópico , Como receber texto para saber mais.

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);
        }
    });
}

Comentários

Durante uma operação de compartilhamento, o aplicativo de origem coloca os dados sendo compartilhados em um objeto DataPackage e envia esse objeto para o aplicativo de destino para processamento. A classe DataPackage inclui vários métodos para dar suporte aos seguintes formatos padrão: text, Rtf, Html, Bitmap e StorageItems. Ele também tem métodos para dar suporte a formatos de dados personalizados. Para usar esses formatos, o aplicativo de origem e o aplicativo de destino já devem estar cientes de que o formato personalizado existe.

Os aplicativos de destino podem usar o objeto DataPackageView para adquirir os dados que estão sendo compartilhados. Além disso, esses aplicativos podem usar a propriedade AvailableFormats para identificar quais formatos o DataPackageView dá suporte ou o método Contains para consultar um formato específico.

Os aplicativos de origem têm a opção de usar o SetDataProvider para atribuir um delegado a um DataPackage, em vez de fornecer os dados imediatamente. Esse processo é útil em situações em que o aplicativo de origem dá suporte a um determinado formato, mas não deseja gerar os dados, a menos que o aplicativo de destino os solicite. Por exemplo, um aplicativo de origem pode dar suporte a uma variedade de formatos de imagem para compartilhar fotos. Em vez de criar várias cópias de cada imagem usando esses formatos, o aplicativo de origem pode usar um delegado que é chamado quando o aplicativo de destino solicita um tipo de formato específico.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1511 10586 SetAcceptedFormatId

Propriedades

AvailableFormats

Retorna os formatos que o DataPackageView contém.
Properties

Obtém um objeto DataPackagePropertySetView , que contém um conjunto somente leitura de propriedades para os dados no objeto DataPackageView .
RequestedOperation

Obtém a operação solicitada (como copiar ou mover). Usado principalmente para ações da área de transferência.

Métodos

Contains(String)

Verifica se o DataPackageView contém um formato de dados específico.
GetApplicationLinkAsync()

Obtém o link do aplicativo no objeto DataPackageView .
GetBitmapAsync()

Obtém a imagem de bitmap contida no DataPackageView
GetDataAsync(String)

Obtém os dados contidos no DataPackageView.
GetHtmlFormatAsync()

Obtém o HTML armazenado no objeto DataPackageView .
GetResourceMapAsync()

Obtém os dados (como uma imagem) referenciados no conteúdo HTML.
GetRtfAsync()

Obtém o conteúdo formatado em rich text (RTF) contido em um DataPackageView.
GetStorageItemsAsync()

Obtém os arquivos e pastas armazenados em um objeto DataPackageView .
GetTextAsync()

Obtém o texto no objeto DataPackageView .
GetTextAsync(String)

Obtém o texto no objeto DataPackageView .
GetUriAsync()

Observação

GetUriAsync pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetApplicationLink ou GetWebLink.

Obtém o URI contido no DataPackageView.
GetWebLinkAsync()

Obtém o link da Web no objeto DataPackageView .
ReportOperationCompleted(DataPackageOperation)

Informa ao sistema que seu aplicativo foi concluído usando o objeto DataPackageView . Usado principalmente para operações de área de transferência.
RequestAccessAsync()

Solicita permissão para desbloquear e acessar um pacote de dados protegido com uma política de proteção.
RequestAccessAsync(String)

Solicita permissão para desbloquear e acessar um pacote de dados protegido com uma política de proteção.
SetAcceptedFormatId(String)

Define a ID de formato aceita.
UnlockAndAssumeEnterpriseIdentity()

Desbloqueia um pacote de dados e pressupõe uma identidade corporativa para ele.

Aplica-se a

Confira também