PackUriHelper.ResolvePartUri(Uri, Uri) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um URI de parte dado um URI de parte de origem e um URI com um caminho relativo para uma parte alvo.
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
Parâmetros
- targetUri
- Uri
O URI relativo à parte alvo.
Devoluções
O URI da parte alvo resolvia-se entre os parâmetros especificados sourcePartUri e os targetUri parâmetros.
Exceções
sourcePartUri ou targetUri é null.
sourcePartUri não é um URI válido de partes.
-ou-
targetUri não é uma URI parente válida.
Exemplos
O exemplo seguinte mostra como usar o ResolvePartUri método.
// 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.
Observações
A tabela seguinte ilustra casos exemplos para ResolvePartUri.
sourcePartUri |
targetUri |
URI devolvido |
|---|---|---|
| /mydoc/markup/page.xml | picture.jpg | /mydoc/markup/picture.jpg |
| /mydoc/markup/page.xml | Imagens/picture.jpg | /mydoc/markup/imagens/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 | .. /imagens/picture.jpg | /mydoc/imagens/picture.jpg |
| / | Imagens/picture.jpg | /imagens/picture.jpg |