Package.GetPart(Uri) メソッド

定義

名前空間:

System.IO.Packaging

アセンブリ:

System.IO.Packaging.dll

パッケージ:

System.IO.Packaging v9.0.0-rc.2.24473.5

ソース:

Package.cs

指定した URI を持つパーツを返します。

public:
 System::IO::Packaging::PackagePart ^ GetPart(Uri ^ partUri);

public System.IO.Packaging.PackagePart GetPart (Uri partUri);

member this.GetPart : Uri -> System.IO.Packaging.PackagePart

Public Function GetPart (partUri As Uri) As PackagePart

パラメーター

partUri

Uri

返されるパーツの Uniform Resource Identifier (URI)。

戻り値

PackagePart

指定した partUri を持つパーツ。

例外

ArgumentNullException

partUri が nullです。

ArgumentException

partUri が有効な PackagePart Uniform Resource Identifier (URI) ではありません。

InvalidOperationException

指定した partUri を持つパーツが、パッケージ内に存在しません。

ObjectDisposedException

パッケージが開いていません (Dispose(Boolean) または Close() が呼び出されました)。

IOException

パッケージは書き込み専用です。

例

次の例は、パッケージに含まれるパーツを検索、取得、および読み取る方法を示しています。

// 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.

' Open the Package.
' ('using' statement insures that 'package' is
'  closed and disposed when it goes out of scope.)
Using package As Package = Package.Open(packagePath, FileMode.Open, FileAccess.Read)
    Dim documentPart As PackagePart = Nothing
    Dim resourcePart As PackagePart = Nothing

    ' Get the Package Relationships and look for
    '   the Document part based on the RelationshipType
    Dim uriDocumentTarget As Uri = Nothing
    For Each relationship As PackageRelationship 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)
    Next relationship

    ' Get the Document part's Relationships,
    '   and look for required resources.
    Dim uriResourceTarget As Uri = Nothing
    For Each relationship As PackageRelationship 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)
    Next relationship

End Using ' end:using(Package package) - Close & dispose package.

注釈

InvalidOperationException指定した を持つパーツが存在しない場合は、 がスローされますpartUri。

メソッドを PartExists 使用して、既存のパーツを参照するかどうかを partUri 判断できます。

既定では、 ZipPackage 抽象 Package 基本クラスの派生実装が提供され、使用されます。 既定の操作では、 GetPart クラスをZipPackage内部的に呼び出GetPartCoreして、ZIP ファイルから要求された部分を返します。

詳細については、 でダウンロード https://www.ecma-international.org/publications-and-standards/standards/ecma-376/できる Open Packaging Conventions (OPC) 仕様を参照してください。

注意 (継承者)

GetPart(Uri) は、派生クラス メソッドを内部的に呼び出して、派生クラス GetPartCore(Uri) に実装されている物理形式に基づいてパーツを実際にフラッシュします。

こちらもご覧ください

• GetParts()
• PartExists(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)