PackUriHelper.ResolvePartUri(Uri, Uri) 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

套件:

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

來源:

PackUriHelper.cs

傳回組件 URI，提供來源組件 URI 以及含有目標組件相對路徑的 URI。

public:
 static Uri ^ ResolvePartUri(Uri ^ sourcePartUri, Uri ^ targetUri);

public static Uri ResolvePartUri (Uri sourcePartUri, Uri targetUri);

static member ResolvePartUri : Uri * Uri -> Uri

Public Shared Function ResolvePartUri (sourcePartUri As Uri, targetUri As Uri) As Uri

參數

sourcePartUri

Uri

來源組件的 URI，或是 "/" 以指定 Package 根目錄。

targetUri

Uri

相對於目標組件的 URI。

傳回

Uri

在指定的 SourcePartUri 與 targetUri 參數之間解析的目標組件之 URI。

例外狀況

ArgumentNullException

sourcePartUri 或 targetUri 為 null。

ArgumentException

sourcePartUri 不是有效的組件 URI。

-或-

targetUri 不是有效的相對 URI。

範例

下列範例會示範如何使用 ResolvePartUri 方法。

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

備註

下表說明的 ResolvePartUri範例案例。

sourcePartUri	targetUri	傳回的 URI
/mydoc/markup/page.xml	picture.jpg	/mydoc/markup/picture.jpg
/mydoc/markup/page.xml	images/picture.jpg	/mydoc/markup/images/picture.jpg
/mydoc/markup/page.xml	./picture.jpg	/mydoc/markup/picture.jpg
/mydoc/markup/page.xml	../picture.jpg	/mydoc/picture.jpg
/mydoc/markup/page.xml	../images/picture.jpg	/mydoc/images/picture.jpg
/	images/picture.jpg	/images/picture.jpg

另請參閱

• GetPartUri(Uri)
• GetRelativeUri(Uri, Uri)
• 開放式封裝慣例規格