PackUriHelper.Create Metod

Definition

Namnområde:: System.IO.Packaging

Sammansättning:: System.IO.Packaging.dll

Sammansättning:: WindowsBase.dll

Sammansättningar:: System.IO.Packaging.dll, WindowsBase.dll

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

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en ny pack-URI.

Överlagringar

Name	Description
Create(Uri)	Skapar en ny pack-URI som pekar på ett paket.
Create(Uri, Uri)	Skapar en pack-URI med en Package URI och URI för en del i paketet.
Create(Uri, Uri, String)	Skapar en pack-URI med en Package URI, URI för en del i paketet och ett "#"-fragment som ska läggas till.

Kommentarer

I följande tabell visas exempelfall för Create metoden.

`packageUri`	`partUri`	`fragment`	Returnerad 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	noll	pack://http:,,www.proseware.com,mypackage.pkg/page2.xaml
`http://www.proseware.com/mypackage.pkg`	/a/page4.xaml	noll	pack://http:,,www.proseware.com,mypackage.pkg/a/page4.xaml
`http://www.proseware.com/mypackage.pkg`	/%41/%61.xml	noll	pack://http:,,www.proseware.com,mypackage.pkg/A/a.xml
`http://www.proseware.com/mypackage.pkg`	/%25XY.xml	noll	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`	noll	noll	pack://http:,,www.proseware.com,mypackage.pkg
`ftp://ftp.proseware.com/packages/mypackage1.abc`	/a/mydoc.xaml	noll	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

Att skapa en pack-URI är en process i flera steg. Ett steg i att skapa en pack-URI är till exempel att ersätta snedstreckstecken packageUri (/) i med kommatecken (,).

Mer information om strängkonvertering och hur paket-URI:er bildas finns i bilaga A.4 "Exempel på strängkonvertering" och bilaga B.3 "Skapa en paket-URI" i specifikationen öppna förpackningskonventioner som är tillgänglig för nedladdning på Specifikationer och licensnedladdningar.

Create(Uri)

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Skapar en ny pack-URI som pekar på ett paket.

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

Parametrar

packageUri: Uri

URI:n för den refererade Package.

Returer

Uri

Pack-URI:n för den Package som refereras av den angivna packageUri.

Undantag

ArgumentNullException

packageUri är null.

ArgumentException

packageUri är inte en absolut URI.

Exempel

I följande exempel visas hur du använder Create metoden för att definiera en pack-URI som refererar till ett paket.

// ------------------------ 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()

Kommentarer

packageUri kanske inte anges som null eller tom.

I följande tabell visas exempelfall för Create.

`packageUri`	Returnerad 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

Att skapa en pack-URI är en process i flera steg. Ett steg i att skapa en pack-URI är till exempel att ersätta snedstreckstecken packageUri (/) i med kommatecken (,).

Se även

Specifikation för Öppna förpackningskonventioner

Gäller för

Create(Uri, Uri)

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Skapar en pack-URI med en Package URI och URI för en del i paketet.

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

Parametrar

packageUri: Uri

URI:n för Package.

partUri: Uri

URI:n för PackagePart i paketet.

Returer

Uri

Pack-URI:n för den angivna PackagePart.

Undantag

ArgumentNullException

packageUri är null.

ArgumentException

packageUri är inte en absolut URI.

-eller-

partUri är inte en giltig URI-syntax för del.

Exempel

I följande exempel visas hur du använder Create(Uri) metoden för att definiera en pack-URI som refererar till ett paket.

// ------------------------ 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()

Kommentarer

packageUri kan inte anges som null eller tom.

Om partUri är nullpekar den returnerade pack-URI:n på paketet.

I följande tabell visas exempelfall för Create metoden.

`packageUri`	`partUri`	Returnerad 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`	noll	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

Att skapa en pack-URI är en process i flera steg. Ett steg i att skapa en pack-URI är till exempel att ersätta snedstreckstecken packageUri (/) i med kommatecken (,).

Se även

Specifikation för Öppna förpackningskonventioner

Gäller för

Create(Uri, Uri, String)

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Källa:: PackUriHelper.PackUriScheme.cs

Skapar en pack-URI med en Package URI, URI för en del i paketet och ett "#"-fragment som ska läggas till.

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

Parametrar

packageUri: Uri

URI:n för Package.

partUri: Uri

URI:n för PackagePart i paketet.

fragment: String

En "#"-referens som identifierar ett element i paketdelen.

Returer

Uri

Paket-URI:n som identifierar det angivna paketet, paketdelen och fragmentet.

Undantag

ArgumentNullException

packageUri är null.

ArgumentException

packageUri är inte en absolut URI.

-eller-

partUri är inte en giltig URI-syntax för del.

-eller-

fragment är tom eller börjar med "#".

Exempel

I följande exempel visas hur du använder Create(Uri) metoden för att definiera en pack-URI som refererar till ett paket.

// ------------------------ 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()

Kommentarer

packageUri kanske inte anges som null eller tom.

Om partUri är nullpekar den returnerade pack-URI:n på paketet.

fragment kan inte vara en tom sträng men kan anges som null. När strängen inte anges som nullmåste den fragment börja med ett #-tecken. Mer information om referenssyntaxen fragment finns i Avsnitt 3.5 "Fragment" av RFC 3986.

I följande tabell visas exempelfall för Create metoden.

`packageUri`	`partUri`	`fragment`	Returnerad 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	noll	pack://http:,,www.proseware.com,mypackage.pkg/page2.xaml
`http://www.proseware.com/mypackage.pkg`	/a/page4.xaml	noll	pack://http:,,www.proseware.com,mypackage.pkg/a/page4.xaml
`http://www.proseware.com/mypackage.pkg`	/%41/%61.xml	noll	pack://http:,,www.proseware.com,mypackage.pkg/A/a.xml
`http://www.proseware.com/mypackage.pkg`	/%25XY.xml	noll	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`	noll	noll	pack://http:,,www.proseware.com,mypackage.pkg
`ftp://ftp.proseware.com/packages/mypackage1.abc`	/a/mydoc.xaml	noll	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

Att skapa en pack-URI är en process i flera steg. Ett steg i att skapa en pack-URI är till exempel att ersätta snedstreckstecken packageUri (/) i med kommatecken (,).

Se även

Specifikation för Öppna förpackningskonventioner

Gäller för

Feedback

Var den här sidan till hjälp?