PackUriHelper.Create Metode

Referensi

Definisi

Ruang nama:: System.IO.Packaging

Rakitan:: System.IO.Packaging.dll

Rakitan:: WindowsBase.dll

Paket:: System.IO.Packaging v6.0.0

Paket:: System.IO.Packaging v7.0.0

Paket:: System.IO.Packaging v8.0.0

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

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat URI paket baru.

Overload

Create(Uri)	Membuat URI paket baru yang menunjuk ke paket.
Create(Uri, Uri)	Membuat URI paket yang Package diberikan URI dan URI bagian dalam paket.
Create(Uri, Uri, String)	Membuat URI paket yang Package diberi URI, URI bagian dalam paket, dan fragmen "#" untuk ditambahkan.

Keterangan

Tabel berikut mengilustrasikan contoh kasus untuk metode .Create

`packageUri`	`partUri`	`fragment`	URI paket yang dikembalikan
`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

Menyusun URI paket adalah proses multi-langkah. Misalnya, satu langkah dalam membentuk URI paket adalah mengganti karakter garis miring (/) dari packageUri dengan koma (,).

Untuk informasi selengkapnya tentang konversi string dan bagaimana URI paket terbentuk, lihat Lampiran A.4 "Contoh Konversi String" dan Lampiran B.3 "Menyusun URI Paket" dalam spesifikasi Konvensi Kemasan Terbuka yang tersedia untuk diunduh di Spesifikasi dan Unduhan Lisensi.

Create(Uri)

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Membuat URI paket baru yang menunjuk ke 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

Parameter

packageUri: Uri

URI dari yang dirujuk Package.

Mengembalikan

Uri

URI paket untuk yang dirujuk Package oleh yang diberikan packageUri.

Pengecualian

ArgumentNullException

packageUriadalah null.

ArgumentException

packageUri bukan URI absolut.

Contoh

Contoh berikut menunjukkan cara menggunakan Create metode untuk menentukan URI paket yang mereferensikan 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()

Keterangan

packageUri mungkin tidak ditentukan sebagai null atau kosong.

Tabel berikut ini mengilustrasikan contoh kasus untuk Create.

`packageUri`	URI paket yang dikembalikan
`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

Menyusun URI paket adalah proses multi-langkah. Misalnya, satu langkah dalam membentuk URI paket adalah mengganti karakter garis miring (/) dari packageUri dengan koma (,).

Lihat juga

Spesifikasi Konvensi Kemasan Terbuka

Berlaku untuk

Create(Uri, Uri)

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Membuat URI paket yang Package diberikan URI dan URI bagian dalam 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

URI dari Package.

partUri: Uri

URI dalam PackagePart paket.

Mengembalikan

Uri

URI paket dari yang diberikan PackagePart.

Pengecualian

ArgumentNullException

packageUriadalah null.

ArgumentException

packageUri bukan URI absolut.

-atau-

partUri bukan sintaks URI bagian yang valid.

Contoh

Contoh berikut menunjukkan cara menggunakan Create(Uri) metode untuk menentukan URI paket yang mereferensikan 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()

Keterangan

packageUri mungkin tidak ditentukan sebagai null atau kosong.

Jika partUri adalah null, URI paket yang dikembalikan menunjuk ke paket.

Tabel berikut mengilustrasikan contoh kasus untuk metode .Create

`packageUri`	`partUri`	URI paket yang dikembalikan
`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

Menyusun URI paket adalah proses multi-langkah. Misalnya, satu langkah dalam membentuk URI paket adalah mengganti karakter garis miring (/) dari packageUri dengan koma (,).

Lihat juga

Spesifikasi Konvensi Kemasan Terbuka

Berlaku untuk

Create(Uri, Uri, String)

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Sumber:: PackUriHelper.PackUriScheme.cs

Membuat URI paket yang Package diberi URI, URI bagian dalam paket, dan fragmen "#" untuk ditambahkan.

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

URI dari Package.

partUri: Uri

URI dalam PackagePart paket.

fragment: String

Referensi "#" yang mengidentifikasi elemen dalam bagian paket.

Mengembalikan

Uri

URI paket yang mengidentifikasi paket, bagian paket, dan fragmen yang ditentukan.

Pengecualian

ArgumentNullException

packageUriadalah null.

ArgumentException

packageUri bukan URI absolut.

-atau-

partUri bukan sintaks URI bagian yang valid.

-atau-

fragment kosong atau dimulai dengan "#".

Contoh

Contoh berikut menunjukkan cara menggunakan Create(Uri) metode untuk menentukan URI paket yang mereferensikan 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()

Keterangan

packageUri mungkin tidak ditentukan sebagai null atau kosong.

Jika partUri adalah null, URI paket yang dikembalikan menunjuk ke paket.

fragment tidak dapat berupa string kosong tetapi dapat ditentukan sebagai null. Ketika tidak ditentukan sebagai null, fragment string harus dimulai dengan karakter '#'. Untuk informasi selengkapnya tentang sintaks fragment referensi, lihat Bagian 3.5 "Fragmen" RFC 3986.

Tabel berikut mengilustrasikan contoh kasus untuk metode .Create

`packageUri`	`partUri`	`fragment`	URI paket yang dikembalikan
`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

Menyusun URI paket adalah proses multi-langkah. Misalnya, satu langkah dalam membentuk URI paket adalah mengganti karakter garis miring (/) dari packageUri dengan koma (,).

Lihat juga

Spesifikasi Konvensi Kemasan Terbuka

Berlaku untuk

Bagikan melalui

PackUriHelper.Create Metode

Definisi

Overload

Keterangan

Create(Uri)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Create(Uri, Uri)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Create(Uri, Uri, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: