PackageStore Classe

Définition

Espace de noms:
System.IO.Packaging
Assembly:
PresentationCore.dll

Représente une collection d’instances spécifiques Package à l’application utilisées en combinaison avec PackWebRequest.

public ref class PackageStore abstract sealed
[System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)]
public static class PackageStore
public static class PackageStore
[<System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)>]
type PackageStore = class
type PackageStore = class
Public Class PackageStore
Héritage
Object
PackageStore
Attributs
SecurityCriticalAttribute

Remarques

Définit PackageStore des collections de références de package ouvertes et actives dans l’application. Les packages ajoutés au fichier PackageStore sont accessibles par leur valeur d’URI de clé. Les PackageStore trois utilisations courantes sont les suivantes :

  1. Accès aux PackagePart données via PackWebRequest.

  2. L’application obtient une instance d’un Package URI du package donné.

  3. Accès aux packages créés et stockés dans un MemoryStream.

Pour améliorer les performances et réduire la surcharge des opérations répétées d’ouverture/fermeture de fichiers, elle PackageStore est utilisée pour gérer les instances de packages accessibles PackWebRequest et directement par l’application. Lors de l’accès aux données dans un package, l’adresse Package d’un demandé PackagePartUri est d’abord vérifiée pour voir si le package est déjà défini et ouvert dans le PackageStore. Si le package est défini comme ouvert dans le PackageStore, les parties demandées sont accessibles directement sans ouvrir et fermer le package à plusieurs reprises pour chaque requête.

Si votre application ouvre un package avec Package.Open, AddPackage peut être appelée pour ajouter le package au PackageStore. RemovePackage doit être appelé ultérieurement pour supprimer le package de la version antérieure à l’appel PackageStorePackage.Close.

Les packages XPS ouverts avec un XpsDocument constructeur sont automatiquement ajoutés et supprimés du PackageStore moment où le document est créé et supprimé. (Vous n’avez pas besoin d’appeler AddPackage ou RemovePackage séparément pour les packages XPS ouverts avec XpsDocument des constructeurs.)

Les autorisations d’E/S de fichier d’un package accessibles via le PackageStore reste identiques aux autorisations d’E/S définies sur le package lorsqu’il est ouvert. La PackageStore seule référence fournit des références aux packages qui ont été ajoutés au magasin. Il incombe à l’application d’ouvrir, de mettre à jour et de fermer correctement chaque package.

Les packages ajoutés à l’environnement PackageStore multithread sont accessibles lorsqu’ils sont utilisés en combinaison avec un analyseur XAML tel que XamlReader.Load. Lors de l’exploitation dans un environnement multithread, l’application doit verrouiller le package avant l’accès.

Méthodes

Nom Description
AddPackage(Uri, Package)

Ajoute un Package au magasin.
GetPackage(Uri)

Retourne l’URI Package spécifié à partir du magasin.
RemovePackage(Uri)

Supprime l’URI Package spécifié du magasin.

S’applique à

Voir aussi