PackageStore Classe

Definição

Representa uma coleção de instâncias específicas Package da aplicação usadas em combinação com PackWebRequest.

public ref class PackageStore abstract sealed
[System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)]
public static class PackageStore
[<System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)>]
type PackageStore = class
Public Class PackageStore
Herança
PackageStore
Atributos

Observações

Define PackageStore uma coleção de referência de pacotes que são abertas e ativas na aplicação. Os pacotes adicionados são PackageStore acedidos pelo seu valor chave de URI. Suporta PackageStore três usos comuns:

  1. Aceder PackagePart a dados através de PackWebRequest.

  2. A aplicação obtém uma instância de um Package dado URI do pacote.

  3. Aceder a pacotes que são criados e armazenados num MemoryStreamarquivo .

Para melhorar o desempenho e minimizar a sobrecarga das operações repetidas de abertura/encerramento de ficheiros, o PackageStore é utilizado para gerir instâncias de pacotes acedidos por PackWebRequest e diretamente pela aplicação. Ao aceder a dados num pacote, o Package endereço de um pedido PackagePartUri é primeiro verificado para verificar se o pacote já está definido e aberto no PackageStorearquivo . Se o pacote estiver definido como aberto no PackageStore, as peças solicitadas podem ser acedidas diretamente sem abrir e fechar repetidamente o pacote para cada pedido.

Se a sua aplicação abrir um pacote com Package.Open, AddPackage pode ser chamada para adicionar o pacote ao PackageStore. RemovePackage deve ser chamado mais tarde para remover o pacote do PackageStore antes de chamar Package.Close.

Os pacotes XPS abertos com um XpsDocument construtor são automaticamente adicionados e removidos quando PackageStore o documento é criado e eliminado. (Não é necessário chamar AddPackage ou RemovePackage separar pacotes XPS abertos com XpsDocument construtores.)

As permissões de I/O de ficheiros de um pacote acedido PackageStore através do pacote mantêm-se as mesmas que as permissões de I/O definidas no pacote quando este é aberto. Só PackageStore fornece referências aos pacotes que foram adicionados à loja. Cabe à aplicação abrir, atualizar e fechar corretamente cada pacote.

Os pacotes adicionados ao PackageStore podem ser acedidos em ambientes multithread quando são usados em combinação com um parser XAML, como XamlReader.Load. Ao operar num ambiente multithread, a aplicação deve bloquear o pacote antes do acesso.

Métodos

Name Description
AddPackage(Uri, Package)

Acrescenta A Package à loja.

GetPackage(Uri)

Devolve-os Package com um URI especificado da loja.

RemovePackage(Uri)

Remove o Package com um URI especificado da loja.

Aplica-se a

Ver também