Exportieren (0) Drucken
Alle erweitern

Package.Open-Methode (String, FileMode, FileAccess)

Aktualisiert: November 2007

Öffnet mit einem angegebenen Dateimodus und einer angegebenen Dateizugriffseinstellung ein Paket in einem angegebenen Pfad.

Namespace:  System.IO.Packaging
Assembly:  WindowsBase (in WindowsBase.dll)

public static Package Open(
	string path,
	FileMode packageMode,
	FileAccess packageAccess
)
public static Package Open(
	String path,
	FileMode packageMode,
	FileAccess packageAccess
)
public static function Open(
	path : String, 
	packageMode : FileMode, 
	packageAccess : FileAccess
) : Package
Sie können diese Methoden nicht in XAML verwenden.

Parameter

path
Typ: System.String
Der Pfad und Dateiname des Pakets.
packageMode
Typ: System.IO.FileMode
Der Dateimodus, in dem das Paket geöffnet werden soll.
packageAccess
Typ: System.IO.FileAccess
Der Dateizugriff, mit dem das Paket geöffnet werden soll.

Rückgabewert

Typ: System.IO.Packaging.Package
Das geöffnete Paket.

AusnahmeBedingung
ArgumentNullException

path ist null.

ArgumentOutOfRangeException

Der Wert für packageMode oder packageAccess ist ungültig.

ZipPackage ist der Standardpakettyp, der von der Open-Methode verwendet wird.

Die Open-Methode öffnet das Paket mit dem Standardattribut None (um ein anderes Attribut anzugeben, verwenden Sie die Open-Methodenüberladung).

Weitere Informationen finden Sie in der OPC (Open Packaging Conventions)-Spezifikation, die unter http://go.microsoft.com/fwlink/?LinkID=71255 heruntergeladen werden kann.

Im folgenden Beispiel wird gezeigt, wie ein Package geöffnet und gelesen wird, das PackageRelationship-Elemente und PackagePart-Elemente gemeinsam mit gespeicherten Daten enthält. Das vollständige Beispiel finden Sie unter Beispiel für das Lesen eines Pakets.

// Open the Package.
// ('using' statement insures that 'package' is
//  closed and disposed when it goes out of scope.)
using (Package package =
    Package.Open(packagePath, FileMode.Open, FileAccess.Read))
{
    PackagePart documentPart = null;
    PackagePart resourcePart = null;

    // Get the Package Relationships and look for
    //   the Document part based on the RelationshipType
    Uri uriDocumentTarget = null;
    foreach (PackageRelationship relationship in
        package.GetRelationshipsByType(PackageRelationshipType))
    {
        // Resolve the Relationship Target Uri
        //   so the Document Part can be retrieved.
        uriDocumentTarget = PackUriHelper.ResolvePartUri(
            new Uri("/", UriKind.Relative), relationship.TargetUri);

        // Open the Document Part, write the contents to a file.
        documentPart = package.GetPart(uriDocumentTarget);
        ExtractPart(documentPart, targetDirectory);
    }

    // Get the Document part's Relationships,
    //   and look for required resources.
    Uri uriResourceTarget = null;
    foreach (PackageRelationship relationship in
        documentPart.GetRelationshipsByType(
                                ResourceRelationshipType))
    {
        // Resolve the Relationship Target Uri
        //   so the Resource Part can be retrieved.
        uriResourceTarget = PackUriHelper.ResolvePartUri(
            documentPart.Uri, relationship.TargetUri);

        // Open the Resource Part and write the contents to a file.
        resourcePart = package.GetPart(uriResourceTarget);
        ExtractPart(resourcePart, targetDirectory);
    }

}// end:using(Package package) - Close & dispose package.


Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft