PackUriHelper.Create Methode

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

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

Gibt zurück

Der Paket-URI für das Package, auf das durch den angegebenen packageUri verwiesen wird.

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, 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 werden Beispielfälle für Createveranschaulicht.

Das Erstellen eines Pack-URI ist ein mehrstufiger Prozess. Ein Schritt beim Erstellen eines Paket-URI besteht beispielsweise darin, den Schrägstrich (/) des packageUri durch Kommas (,) zu ersetzen.

Weitere Informationen zur Zeichenfolgenkonvertierung und zur Erstellung von Pack-URIs finden Sie unter Anhang A.4 "Beispiele für die Zeichenfolgenkonvertierung" und Anhang B.3 "Erstellen eines Pack-URI" in der Spezifikation für Open Packaging Conventions, die unter Spezifikationen und Lizenzdownloads zum Download verfügbar ist.

Weitere Informationen

• Spezifikation für Offene Verpackungskonventionen

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

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

Gibt zurück

Der Paket-URI des angegebenen PackagePart.

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, 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 ist, zeigt nullder zurückgegebene Pack-URI auf das Paket.

In der folgenden Tabelle werden Beispielfälle für die Create -Methode veranschaulicht.

Das Erstellen eines Pack-URI ist ein mehrstufiger Prozess. Ein Schritt beim Erstellen eines Paket-URI besteht beispielsweise darin, den Schrägstrich (/) des packageUri durch Kommas (,) zu ersetzen.

Weitere Informationen zur Zeichenfolgenkonvertierung und zur Erstellung von Pack-URIs finden Sie unter Anhang A.4 "Beispiele für die Zeichenfolgenkonvertierung" und Anhang B.3 "Erstellen eines Pack-URI" in der Spezifikation für Open Packaging Conventions, die unter Spezifikationen und Lizenzdownloads zum Download verfügbar ist.

Weitere Informationen

• Spezifikation für Offene Verpackungskonventionen

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

Quelle:

PackUriHelper.PackUriScheme.cs

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

Gibt zurück

Der Paket-URI, der das angegebene Paket, Paketteil und Fragment angibt.

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, 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 ist, zeigt nullder zurückgegebene Pack-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 von fragment Verweisen finden Sie in Abschnitt 3.5 "Fragment" von RFC 3986.

In der folgenden Tabelle werden Beispielfälle für die Create -Methode veranschaulicht.

Das Erstellen eines Pack-URI ist ein mehrstufiger Prozess. Ein Schritt beim Erstellen eines Paket-URI besteht beispielsweise darin, den Schrägstrich (/) des packageUri durch Kommas (,) zu ersetzen.

Weitere Informationen zur Zeichenfolgenkonvertierung und zur Erstellung von Pack-URIs finden Sie unter Anhang A.4 "Beispiele für die Zeichenfolgenkonvertierung" und Anhang B.3 "Erstellen eines Pack-URI" in der Spezifikation für Open Packaging Conventions, die unter Spezifikationen und Lizenzdownloads zum Download verfügbar ist.

Weitere Informationen

• Spezifikation für Offene Verpackungskonventionen