PackUriHelper.Create Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO.Packaging

Zestaw:: System.IO.Packaging.dll

Zestaw:: WindowsBase.dll

Pakiet:: System.IO.Packaging v6.0.0

Pakiet:: System.IO.Packaging v7.0.0

Pakiet:: System.IO.Packaging v8.0.0

Pakiet:: System.IO.Packaging v9.0.0-preview.2.24128.5

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nowy identyfikator URI pakietu.

Przeciążenia

Create(Uri)	Tworzy nowy identyfikator URI pakietu wskazujący pakiet.
Create(Uri, Uri)	Tworzy identyfikator URI pakietu przy użyciu identyfikatora Package URI i identyfikatora URI części pakietu.
Create(Uri, Uri, String)	Tworzy identyfikator URI pakietu przy użyciu identyfikatora Package URI, identyfikatora URI części w pakiecie i fragmentu "#", który ma być dołączany.

Uwagi

W poniższej Create tabeli przedstawiono przykładowe przypadki dla metody .

`packageUri`	`partUri`	`fragment`	Zwracany identyfikator URI pakietu
`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

Tworzenie identyfikatora URI pakietu jest procesem wieloetapowym. Na przykład jeden krok podczas tworzenia identyfikatora URI pakietu polega na zastąpieniu ukośnika (/) znaków packageUri ukośnika (/) przecinków (,).

Aby uzyskać więcej informacji na temat konwersji ciągów i sposobu tworzenia identyfikatorów URI pakietów, zobacz Dodatek A.4 "Przykłady konwersji ciągów" i dodatek B.3 "Tworzenie identyfikatora URI pakietu" w specyfikacji Open Packaging Conventions dostępne do pobrania w specyfikacji i pobieraniu licencji.

Create(Uri)

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Tworzy nowy identyfikator URI pakietu wskazujący pakiet.

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

Parametry

packageUri: Uri

Identyfikator URI odwołania Package.

Zwraca

Uri

Identyfikator URI pakietu dla Package elementu, do których odwołuje się dany packageUrielement .

Wyjątki

ArgumentNullException

packageUri to null.

ArgumentException

packageUri nie jest bezwzględnym identyfikatorem URI.

Przykłady

W poniższym przykładzie pokazano, jak użyć Create metody do zdefiniowania identyfikatora URI pakietu, który odwołuje się do pakietu.

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

Uwagi

packageUri nie może być określony jako null lub pusty.

W poniższej tabeli przedstawiono przykładowe przypadki dla programu Create.

`packageUri`	Identyfikator URI zwróconego pakietu
`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

Tworzenie identyfikatora URI pakietu jest procesem wieloetapowym. Na przykład jednym krokiem tworzenia identyfikatora URI pakietu jest zastąpienie ukośnika (/) znaków packageUri ukośnika (/) przecinków (,).

Zobacz też

Specyfikacja konwencji otwierania pakietów

Dotyczy

Create(Uri, Uri)

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Tworzy identyfikator URI pakietu przy użyciu identyfikatora Package URI i identyfikatora URI części pakietu.

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

Parametry

packageUri: Uri

Identyfikator URI obiektu Package.

partUri: Uri

Identyfikator URI elementu PackagePart w pakiecie.

Zwraca

Uri

Identyfikator URI pakietu danego PackagePartelementu .

Wyjątki

ArgumentNullException

packageUri to null.

ArgumentException

packageUri nie jest bezwzględnym identyfikatorem URI.

-lub-

partUri nie jest prawidłową składnią identyfikatora URI części.

Przykłady

W poniższym przykładzie pokazano, jak użyć Create(Uri) metody do zdefiniowania identyfikatora URI pakietu, który odwołuje się do pakietu.

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

Uwagi

packageUri nie może być określona jako null lub pusta.

Jeśli partUri ma nullwartość , zwrócony identyfikator URI pakietu wskazuje pakiet.

W poniższej tabeli przedstawiono przykładowe przypadki dla Create metody .

`packageUri`	`partUri`	Identyfikator URI zwróconego pakietu
`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

Zobacz też

Specyfikacja konwencji otwierania pakietów

Dotyczy

Create(Uri, Uri, String)

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Źródło:: PackUriHelper.PackUriScheme.cs

Tworzy identyfikator URI pakietu z identyfikatorem Package URI, identyfikatorem URI części w pakiecie i fragmentem "#" do dołączenia.

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

Parametry

packageUri: Uri

Identyfikator URI obiektu Package.

partUri: Uri

Identyfikator URI elementu PackagePart w pakiecie.

fragment: String

Odwołanie "#" identyfikujące element w części pakietu.

Zwraca

Uri

Identyfikator URI pakietu identyfikujący określony pakiet, część pakietu i fragment.

Wyjątki

ArgumentNullException

packageUri to null.

ArgumentException

packageUri nie jest bezwzględnym identyfikatorem URI.

-lub-

partUri nie jest prawidłową składnią identyfikatora URI części.

-lub-

fragment jest pusty lub zaczyna się od ciągu "#".

Przykłady

W poniższym przykładzie pokazano, jak użyć Create(Uri) metody do zdefiniowania identyfikatora URI pakietu, który odwołuje się do pakietu.

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

Uwagi

packageUri nie może być określony jako null lub pusty.

Jeśli partUri ma nullwartość , zwrócony identyfikator URI pakietu wskazuje pakiet.

fragment nie może być pustym ciągiem, ale można go określić jako null. Jeśli nie zostanie określony jako null, fragment ciąg musi zaczynać się od znaku "#". Aby uzyskać więcej informacji na temat składni fragment odwołań, zobacz sekcję 3.5 "Fragment" RFC 3986.

W poniższej tabeli przedstawiono przykładowe przypadki dla Create metody .

`packageUri`	`partUri`	`fragment`	Identyfikator URI zwróconego pakietu
`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

Zobacz też

Specyfikacja konwencji otwierania pakietów

Dotyczy

Udostępnij za pośrednictwem

PackUriHelper.Create Metoda

Definicja

Przeciążenia

Uwagi

Create(Uri)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Create(Uri, Uri)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Create(Uri, Uri, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby