Cette documentation est archivée et n’est pas conservée.

System.IO.Packaging, espace de noms

Provides classes that support storage of multiple data objects in a single container.

Package is an abstract class that can be used to organize objects into a single entity of a defined physical format for portability and efficient access.

A ZIP file is the primary physical format for the Package. Other Package implementations might use other physical formats such as an XML document, a database, or Web service.

Like a file system, items contained in a Package are referenced in a hierarchical organization of folders and files.

While Package itself is an abstract class, the ZipPackage derived class is used as default by the Open method.

A PackagePart ("part") is the abstract class which represents an object that is stored in a Package.

A PackageRelationship ("relationship") defines an association between a source Package or PackagePart, and a target object. A PackageRelationship can be one of two types, each of which can be one of two forms.

  • Package-level relationship (created by Package.CreateRelationship)

    • Between a Package to a target part in the package.

    • Between a Package to a target resource outside the package.

  • Part-level relationship (created by PackagePart.CreateRelationship)

    • Between a source PackagePart to another target part in the package.

    • Between a source PackagePart to a target resource outside the package.

The relationship's source Package or source PackagePart is considered the "owner" of the relationship. When the source object is deleted, all the relationships owned by the source object are also deleted. The process of creating or deleting a relationship does not physically change either the source and target objects in any way.

A PackageDigitalSignature ("digital signature") is a composition of parts and relationships representing a digital signature included with a Package. The digital signature identifies the originator and validates that the signed parts and relationships contained in the Package have not been modified.

Packages also support Digital Rights Management (DRM) which allows content elements in a Package to be encrypted with specific access rights granted to authorized users.

Based the Package architecture, an XpsDocument is a package type designed for storing documents based on the open XML Paper Specification (XPS).

Microsoft .NET Framework version 3.0 uses packages to store content, resources, and relationships for pages and documents using a standard ZIP file by default. Like with any ZIP file, your application can use the System.IO.Packaging classes to store and optionally protect any type or number of data files in a single efficient to access container.

For more information see the Open Packaging Conventions (OPC) specification available for download at http://go.microsoft.com/fwlink/?LinkID=71255.

For a list of System.IO.Packaging related example programs, see the following topics:

 ClasseDescription
Classe publiqueEncryptedPackageEnvelopeRepresents an OLE compound file that contains an encrypted package.
Classe publiquePackageRepresents a container that can store multiple data objects.
Classe publiquePackageDigitalSignatureRepresents a digital signature that is applied to a set of package parts and relationships.
Classe publiquePackageDigitalSignatureManagerProvides a utility class for the creation and verification of digital signatures in a Package.
Classe publiquePackagePartProvides a base class for parts stored in a Package. This class is abstract.
Classe publiquePackagePartCollectionRepresents a collection of PackagePart objects.
Classe publiquePackagePropertiesRepresents the core properties of a Package.
Classe publiquePackageRelationshipRepresents an association between a source Package or PackagePart, and a target object which can be a PackagePart or external resource.
Classe publiquePackageRelationshipCollectionRepresents a collection of PackageRelationship elements that are owned by a given PackagePart or the Package.
Classe publiquePackageRelationshipSelectorDefines PackageRelationship criteria to select part-level or package-level relationships.
Classe publiquePackageStoreRepresents a collection of application-specific Package instances used in combination with PackWebRequest.
Classe publiquePackUriHelperProvides utility methods to compose and parse pack URI objects.
Classe publiquePackWebRequestMakes a request to an entire PackagePart or to a PackagePart in a package, identified by a pack URI.
Classe publiquePackWebRequestFactoryRepresents the class that is invoked when an instance of a pack URI PackWebRequest is created.
Classe publiquePackWebResponseRepresents a response of a PackWebRequest. This class cannot be inherited.
Classe publiqueRightsManagementInformationRepresents Digital Rights Management (DRM) information that is stored in an EncryptedPackageEnvelope.
Classe publiqueSignatureVerificationEventArgs Specifies the event args provided to the InvalidSignatureEventHandler.
Classe publiqueStorageInfoProvides access and information for manipulating data stores in a Package.
Classe publiqueStreamInfoProvides access and information for manipulating I/O streams within a Package.
Classe publiqueZipPackageImplements a derived subclass of the abstract Package base class—the ZipPackage class uses a ZIP archive as the container store. This class cannot be inherited.
Classe publiqueZipPackagePartRepresents a part that is stored in a ZipPackage. This class cannot be inherited.

 DéléguéDescription
Délégué publicInvalidSignatureEventHandlerRepresents the method that handles the InvalidSignatureEvent that is raised when VerifySignatures detects an invalid signature.

 ÉnumérationDescription
Énumération publiqueCertificateEmbeddingOptionSpecifies the location where the X.509 certificate that is used in signing is stored.
Énumération publiqueCompressionOptionSpecifies the compression level for content that is stored in a PackagePart.
Énumération publiqueEncryptionOptionSpecifies the encryption option for parts in a Package.
Énumération publiquePackageRelationshipSelectorTypeSpecifies the type of selection criteria that is used to match and return PackageRelationship selections through a PackageRelationshipSelector.
Énumération publiqueTargetModeSpecifies whether the target of a PackageRelationship is inside or outside the Package.
Énumération publiqueVerifyResultSpecifies the result of a certificate or signature verification.
Afficher: