PackUriHelper.Create Methode

Definition

Namespace:: System.IO.Packaging

Assembly:: System.IO.Packaging.dll

Assembly:: WindowsBase.dll

Assemblys:: System.IO.Packaging.dll, WindowsBase.dll

Paket:: System.IO.Packaging v11.0.0-preview.4.26230.115

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt einen neuen Pack-URI.

Überlädt

Name	Beschreibung
Create(Uri)	Erstellt einen neuen Pack-URI, der auf ein Paket verweist.
Create(Uri, Uri)	Erstellt einen Pack-URI mit einem Package URI und dem URI eines Teils im Paket.
Create(Uri, Uri, String)	Erstellt einen Pack-URI mit einem Package URI, dem URI eines Teils im Paket und einem anzufügenden "#"-Fragment.

Hinweise

In der folgenden Tabelle sind Beispielfälle für die Create Methode dargestellt.

`packageUri`	`partUri`	`fragment`	Zurückgegebener Paket-URI
`http://www.proseware.com/mypackage.pkg`	/page1.xaml	#intro	pack://http:,,www.proseware.com,mypackage.pkg/page1.xaml#intro
`http://www.proseware.com/mypackage.pkg`	/page2.xaml	null	pack://http:,,www.proseware.com,mypackage.pkg/page2.xaml
`http://www.proseware.com/mypackage.pkg`	/a/page4.xaml	null	pack://http:,,www.proseware.com,mypackage.pkg/a/page4.xaml
`http://www.proseware.com/mypackage.pkg`	/%41/%61.xml	null	pack://http:,www.proseware.com,mypackage.pkg/A/a.xml
`http://www.proseware.com/mypackage.pkg`	/%25XY.xml	null	pack://http:,,www.proseware.com,mypackage.pkg/%25XY.xml
`http://www.proseware.com/mypackage.pkg`	/a/page5.xaml	#summary	pack://http:,,www.proseware.com,mypackage.pkg/a/page5.xaml#summary
`http://www.proseware.com/packages.aspx?pkg04`	/page1.xaml	#intro	pack://http:,,www.proseware.com,packages.aspx%3fpkg04/page1.xaml#intro
`http://www.proseware.com/mypackage.pkg`	null	null	pack://http:,,www.proseware.com,mypackage.pkg
`ftp://ftp.proseware.com/packages/mypackage1.abc`	/a/mydoc.xaml	null	pack://ftp:,,ftp.proseware.com,packages,mypackage1.abc/a/mydoc.xaml
`file:///d:/packages/mypackage2.pkg`	/a/bar.xaml	#xref	pack://file:,,,d:,packages,mypackage2.pkg/a/bar.xaml#xref

Das Erstellen eines Pack-URI ist ein mehrstufiger Prozess. Beispielsweise besteht ein Schritt bei der Erstellung eines Pack-URI darin, die Schrägstrichzeichen (/) der packageUri durch Kommas (,) zu ersetzen.

Weitere Informationen zur Zeichenfolgenkonvertierung und zur Erstellung von Paket-URIs finden Sie in Anhang A.4 "Zeichenfolgenkonvertierungsbeispiele" und Anhang B.3 "Verfassen eines Pack-URI" in der Open Packaging Conventions-Spezifikation, die für den Download unter "Spezifikationen" und "Lizenzdownloads" zur Verfügung steht.

Create(Uri)

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Erstellt einen neuen Pack-URI, der auf ein Paket verweist.

public:
 static Uri ^ Create(Uri ^ packageUri);

public static Uri Create(Uri packageUri);

static member Create : Uri -> Uri

Public Shared Function Create (packageUri As Uri) As Uri

Parameter

packageUri: Uri

Der URI der referenzierten Package.

Gibt zurück

Uri

Der Pack-URI für den Package vom angegebenen .packageUri

Ausnahmen

ArgumentNullException

packageUri ist null.

ArgumentException

packageUri ist kein absoluter URI.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der Create Methode einen Pack-URI definieren, der auf ein Paket verweist.

// ------------------------ GetFixedDocument --------------------------
/// <summary>
///   Returns the fixed document at a given URI within
///   the currently open XPS package.</summary>
/// <param name="fixedDocUri">
///   The URI of the fixed document to return.</param>
/// <returns>
///   The fixed document at a given URI
///   within the current XPS package.</returns>
private FixedDocument GetFixedDocument(Uri fixedDocUri)
{
    FixedDocument fixedDocument = null;

    // Create the URI for the fixed document within the package. The URI
    // is used to set the Parser context so fonts & other items can load.
    Uri tempUri = new Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute);
    ParserContext parserContext = new ParserContext();
    parserContext.BaseUri = PackUriHelper.Create(tempUri);

    // Retrieve the fixed document.
    PackagePart fixedDocPart = _xpsPackage.GetPart(fixedDocUri);
    if (fixedDocPart != null)
    {
        object fixedObject =
            XamlReader.Load(fixedDocPart.GetStream(), parserContext);
        if (fixedObject != null)
            fixedDocument = fixedObject as FixedDocument;
    }

    return fixedDocument;
}// end:GetFixedDocument()

' ------------------------ GetFixedDocument --------------------------
''' <summary>
'''   Returns the fixed document at a given URI within
'''   the currently open XPS package.</summary>
''' <param name="fixedDocUri">
'''   The URI of the fixed document to return.</param>
''' <returns>
'''   The fixed document at a given URI
'''   within the current XPS package.</returns>
Private Function GetFixedDocument(ByVal fixedDocUri As Uri) As FixedDocument
    Dim fixedDocument As FixedDocument = Nothing

    ' Create the URI for the fixed document within the package. The URI
    ' is used to set the Parser context so fonts & other items can load.
    Dim tempUri As New Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute)
    Dim parserContext As New ParserContext()
    parserContext.BaseUri = PackUriHelper.Create(tempUri)

    ' Retrieve the fixed document.
    Dim fixedDocPart As PackagePart = _xpsPackage.GetPart(fixedDocUri)
    If fixedDocPart IsNot Nothing Then
        Dim fixedObject As Object = XamlReader.Load(fixedDocPart.GetStream(), parserContext)
        If fixedObject IsNot Nothing Then
            fixedDocument = TryCast(fixedObject, FixedDocument)
        End If
    End If

    Return fixedDocument
End Function ' end:GetFixedDocument()

Hinweise

packageUri darf nicht als null oder leer angegeben werden.

In der folgenden Tabelle sind Beispielfälle für Create.

`packageUri`	Zurückgegebener Paket-URI
`http://www.proseware.com/mypackage.pkg`	pack://http:,,www.proseware.com,mypackage.pkg
ftp://ftp.proseware.com/packages/mypackage1.abc	pack://ftp:,,ftp.proseware.com,packages,mypackage1.abc
file:///d:/packages/mypackage2.pkg	pack://file:,,,d:,packages,mypackage2.pkg

Weitere Informationen

Spezifikation der Open Packaging-Konventionen

Gilt für:

Create(Uri, Uri)

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Erstellt einen Pack-URI mit einem Package URI und dem URI eines Teils im Paket.

public:
 static Uri ^ Create(Uri ^ packageUri, Uri ^ partUri);

public static Uri Create(Uri packageUri, Uri? partUri);

public static Uri Create(Uri packageUri, Uri partUri);

static member Create : Uri * Uri -> Uri

Public Shared Function Create (packageUri As Uri, partUri As Uri) As Uri

Parameter

packageUri: Uri

Der URI der Package.

partUri: Uri

Der URI des PackagePart Pakets.

Gibt zurück

Uri

Der Pack-URI des angegebenen PackagePart.

Ausnahmen

ArgumentNullException

packageUri ist null.

ArgumentException

packageUri ist kein absoluter URI.

-oder-

partUri ist keine gültige Teil-URI-Syntax.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der Create(Uri) Methode einen Pack-URI definieren, der auf ein Paket verweist.

// ------------------------ GetFixedDocument --------------------------
/// <summary>
///   Returns the fixed document at a given URI within
///   the currently open XPS package.</summary>
/// <param name="fixedDocUri">
///   The URI of the fixed document to return.</param>
/// <returns>
///   The fixed document at a given URI
///   within the current XPS package.</returns>
private FixedDocument GetFixedDocument(Uri fixedDocUri)
{
    FixedDocument fixedDocument = null;

    // Create the URI for the fixed document within the package. The URI
    // is used to set the Parser context so fonts & other items can load.
    Uri tempUri = new Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute);
    ParserContext parserContext = new ParserContext();
    parserContext.BaseUri = PackUriHelper.Create(tempUri);

    // Retrieve the fixed document.
    PackagePart fixedDocPart = _xpsPackage.GetPart(fixedDocUri);
    if (fixedDocPart != null)
    {
        object fixedObject =
            XamlReader.Load(fixedDocPart.GetStream(), parserContext);
        if (fixedObject != null)
            fixedDocument = fixedObject as FixedDocument;
    }

    return fixedDocument;
}// end:GetFixedDocument()

' ------------------------ GetFixedDocument --------------------------
''' <summary>
'''   Returns the fixed document at a given URI within
'''   the currently open XPS package.</summary>
''' <param name="fixedDocUri">
'''   The URI of the fixed document to return.</param>
''' <returns>
'''   The fixed document at a given URI
'''   within the current XPS package.</returns>
Private Function GetFixedDocument(ByVal fixedDocUri As Uri) As FixedDocument
    Dim fixedDocument As FixedDocument = Nothing

    ' Create the URI for the fixed document within the package. The URI
    ' is used to set the Parser context so fonts & other items can load.
    Dim tempUri As New Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute)
    Dim parserContext As New ParserContext()
    parserContext.BaseUri = PackUriHelper.Create(tempUri)

    ' Retrieve the fixed document.
    Dim fixedDocPart As PackagePart = _xpsPackage.GetPart(fixedDocUri)
    If fixedDocPart IsNot Nothing Then
        Dim fixedObject As Object = XamlReader.Load(fixedDocPart.GetStream(), parserContext)
        If fixedObject IsNot Nothing Then
            fixedDocument = TryCast(fixedObject, FixedDocument)
        End If
    End If

    Return fixedDocument
End Function ' end:GetFixedDocument()

Hinweise

packageUri darf nicht als NULL oder leer angegeben werden.

Wenn partUri dies der Wert ist null, verweist der zurückgegebene Paket-URI auf das Paket.

In der folgenden Tabelle sind Beispielfälle für die Create Methode dargestellt.

`packageUri`	`partUri`	Zurückgegebener Paket-URI
`http://www.proseware.com/mypackage.pkg`	/page2.xaml	pack://http:,,www.proseware.com,mypackage.pkg/page2.xaml
`http://www.proseware.com/mypackage.pkg`	/a/page4.xaml	pack://http:,,www.proseware.com,mypackage.pkg/a/page4.xaml
`http://www.proseware.com/mypackage.pkg`	/%41/%61.xml	pack://http:,www.proseware.com,mypackage.pkg/A/a.xml
`http://www.proseware.com/mypackage.pkg`	/%25XY.xml	pack://http:,,www.proseware.com,mypackage.pkg/%25XY.xml
`http://www.proseware.com/mypackage.pkg`	null	pack://http:,,www.proseware.com,mypackage.pkg
ftp://ftp.proseware.com/packages/mypackage1.abc	/a/mydoc.xaml	pack://ftp:,,ftp.proseware.com,packages,mypackage1.abc/a/mydoc.xaml
file:///d:/packages/mypackage2.pkg	/a/bar.xaml	pack://file:,,,d:,packages,mypackage2.pkg/a/bar.xaml

Weitere Informationen

Spezifikation der Open Packaging-Konventionen

Gilt für:

Create(Uri, Uri, String)

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Quelle:: PackUriHelper.PackUriScheme.cs

Erstellt einen Pack-URI mit einem Package URI, dem URI eines Teils im Paket und einem anzufügenden "#"-Fragment.

public:
 static Uri ^ Create(Uri ^ packageUri, Uri ^ partUri, System::String ^ fragment);

public static Uri Create(Uri packageUri, Uri? partUri, string? fragment);

public static Uri Create(Uri packageUri, Uri partUri, string fragment);

static member Create : Uri * Uri * string -> Uri

Public Shared Function Create (packageUri As Uri, partUri As Uri, fragment As String) As Uri

Parameter

packageUri: Uri

Der URI der Package.

partUri: Uri

Der URI des PackagePart Pakets.

fragment: String

Ein "#"-Verweis, der ein Element innerhalb des Paketteils identifiziert.

Gibt zurück

Uri

Der Pack-URI, der das angegebene Paket, paketteil und fragment identifiziert.

Ausnahmen

ArgumentNullException

packageUri ist null.

ArgumentException

packageUri ist kein absoluter URI.

-oder-

partUri ist keine gültige Teil-URI-Syntax.

-oder-

fragment ist leer oder beginnt mit "#".

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der Create(Uri) Methode einen Pack-URI definieren, der auf ein Paket verweist.

// ------------------------ GetFixedDocument --------------------------
/// <summary>
///   Returns the fixed document at a given URI within
///   the currently open XPS package.</summary>
/// <param name="fixedDocUri">
///   The URI of the fixed document to return.</param>
/// <returns>
///   The fixed document at a given URI
///   within the current XPS package.</returns>
private FixedDocument GetFixedDocument(Uri fixedDocUri)
{
    FixedDocument fixedDocument = null;

    // Create the URI for the fixed document within the package. The URI
    // is used to set the Parser context so fonts & other items can load.
    Uri tempUri = new Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute);
    ParserContext parserContext = new ParserContext();
    parserContext.BaseUri = PackUriHelper.Create(tempUri);

    // Retrieve the fixed document.
    PackagePart fixedDocPart = _xpsPackage.GetPart(fixedDocUri);
    if (fixedDocPart != null)
    {
        object fixedObject =
            XamlReader.Load(fixedDocPart.GetStream(), parserContext);
        if (fixedObject != null)
            fixedDocument = fixedObject as FixedDocument;
    }

    return fixedDocument;
}// end:GetFixedDocument()

' ------------------------ GetFixedDocument --------------------------
''' <summary>
'''   Returns the fixed document at a given URI within
'''   the currently open XPS package.</summary>
''' <param name="fixedDocUri">
'''   The URI of the fixed document to return.</param>
''' <returns>
'''   The fixed document at a given URI
'''   within the current XPS package.</returns>
Private Function GetFixedDocument(ByVal fixedDocUri As Uri) As FixedDocument
    Dim fixedDocument As FixedDocument = Nothing

    ' Create the URI for the fixed document within the package. The URI
    ' is used to set the Parser context so fonts & other items can load.
    Dim tempUri As New Uri(_xpsDocumentPath, UriKind.RelativeOrAbsolute)
    Dim parserContext As New ParserContext()
    parserContext.BaseUri = PackUriHelper.Create(tempUri)

    ' Retrieve the fixed document.
    Dim fixedDocPart As PackagePart = _xpsPackage.GetPart(fixedDocUri)
    If fixedDocPart IsNot Nothing Then
        Dim fixedObject As Object = XamlReader.Load(fixedDocPart.GetStream(), parserContext)
        If fixedObject IsNot Nothing Then
            fixedDocument = TryCast(fixedObject, FixedDocument)
        End If
    End If

    Return fixedDocument
End Function ' end:GetFixedDocument()

Hinweise

packageUri darf nicht als null oder leer angegeben werden.

Wenn partUri dies der Wert ist null, verweist der zurückgegebene Paket-URI auf das Paket.

fragment kann keine leere Zeichenfolge sein, kann aber als nullangegeben werden. Wenn sie nicht als nullangegeben ist, muss die fragment Zeichenfolge mit einem "#"-Zeichen beginnen. Weitere Informationen zur Syntax der fragment Verweise finden Sie unter Abschnitt 3.5 "Fragment" von RFC 3986.

In der folgenden Tabelle sind Beispielfälle für die Create Methode dargestellt.

`packageUri`	`partUri`	`fragment`	Zurückgegebener Paket-URI
`http://www.proseware.com/mypackage.pkg`	/page1.xaml	#intro	pack://http:,,www.proseware.com,mypackage.pkg/page1.xaml#intro
`http://www.proseware.com/mypackage.pkg`	/page2.xaml	null	pack://http:,,www.proseware.com,mypackage.pkg/page2.xaml
`http://www.proseware.com/mypackage.pkg`	/a/page4.xaml	null	pack://http:,,www.proseware.com,mypackage.pkg/a/page4.xaml
`http://www.proseware.com/mypackage.pkg`	/%41/%61.xml	null	pack://http:,www.proseware.com,mypackage.pkg/A/a.xml
`http://www.proseware.com/mypackage.pkg`	/%25XY.xml	null	pack://http:,,www.proseware.com,mypackage.pkg/%25XY.xml
`http://www.proseware.com/mypackage.pkg`	/a/page5.xaml	#summary	pack://http:,,www.proseware.com,mypackage.pkg/a/page5.xaml#summary
`http://www.proseware.com/packages.aspx?pkg04`	/page1.xaml	#intro	pack://http:,,www.proseware.com,packages.aspx%3fpkg04/page1.xaml#intro
`http://www.proseware.com/mypackage.pkg`	null	null	pack://http:,,www.proseware.com,mypackage.pkg
`ftp://ftp.proseware.com/packages/mypackage1.abc`	/a/mydoc.xaml	null	pack://ftp:,,ftp.proseware.com,packages,mypackage1.abc/a/mydoc.xaml
`file:///d:/packages/mypackage2.pkg`	/a/bar.xaml	#xref	pack://file:,,,d:,packages,mypackage2.pkg/a/bar.xaml#xref

Weitere Informationen

Spezifikation der Open Packaging-Konventionen

Gilt für:

Feedback

War diese Seite hilfreich?