Package.CreatePart Metódus

Definíció

Névtér:: System.IO.Packaging

Szerelvény:: WindowsBase.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Létrehoz egy új csomagrészt.

Túlterhelések

Name	Description
CreatePart(Uri, String)	Létrehoz egy új tömörítetlen részt egy adott URI-val és tartalomtípussal.
CreatePart(Uri, String, CompressionOption)	Létrehoz egy új részt egy adott URI, tartalomtípus és tömörítési beállítással.

Példák

Az alábbi példa bemutatja, hogyan hozhat létre újat PackagePart , majd tárolhat adatokat a részbe.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Megjegyzések

CreatePart Inicializál egy üres Stream részt az új részhez. Ez a PackagePart.GetStream módszer a részhez társított streampéldányra mutató hivatkozás lekérésére használható.

A csomagrészekről további információt az Open Packaging Conventions (OPC) open packaging conventions (OPC) specifikációjának 1.1. szakaszában talál, amely a következő címen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/tölthető le: .

CreatePart(Uri, String)

Létrehoz egy új tömörítetlen részt egy adott URI-val és tartalomtípussal.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType);

public System.IO.Packaging.PackagePart CreatePart(Uri partUri, string contentType);

member this.CreatePart : Uri * string -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String) As PackagePart

Paraméterek

partUri: Uri

Az új rész egységes erőforrás-azonosítója (URI).

contentType: String

Az adatfolyam tartalomtípusa.

Válaszok

PackagePart

Az új létrehozott rész.

Kivételek

ArgumentNullException

partUri vagy contentType az null.

ArgumentException

partUri nem érvényes PackagePart URI.

InvalidOperationException

A megadott partUri rész már megtalálható a csomagban.

ObjectDisposedException

A csomag nincs megnyitva (Dispose(Boolean) vagy Close() meghívva van).

IOException

A csomag írásvédett (új rész nem adható hozzá).

Példák

Az alábbi példa bemutatja, hogyan hozhat létre újat PackagePart , majd tárolhat adatokat a részbe.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Megjegyzések

CreatePart Inicializál egy üres Stream részt az új részhez. Ez a PackagePart.GetStream módszer a részhez társított streampéldányra mutató hivatkozás lekérésére használható.

A rész CompressionOption az CompressionOption.NotCompressed.

A csomagrészekkel kapcsolatos további információkért tekintse meg az Open Packaging Conventions (OPC) specifikációjának 1.1. szakaszát, amely a következő címen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/tölthető le: .

Megjegyzések az öröklőkhöz

CreatePart(Uri, String) belsőleg meghívja a származtatott osztály metódusát CreatePartCore(Uri, String, CompressionOption) , hogy ténylegesen hozza létre a részt a származtatott osztályban implementált fizikai formátum alapján.

Lásd még

A következőre érvényes:

CreatePart(Uri, String, CompressionOption)

Létrehoz egy új részt egy adott URI, tartalomtípus és tömörítési beállítással.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType, System::IO::Packaging::CompressionOption compressionOption);

public System.IO.Packaging.PackagePart CreatePart(Uri partUri, string contentType, System.IO.Packaging.CompressionOption compressionOption);

member this.CreatePart : Uri * string * System.IO.Packaging.CompressionOption -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

Paraméterek

partUri: Uri

Az új rész URI-ja.

contentType: String

Az adatfolyam tartalomtípusa.

compressionOption: CompressionOption

Az adatfolyam NotCompressed vagy Normal a tömörítés tömörítési lehetősége.

Válaszok

PackagePart

Az új létrehozott rész.

Kivételek

ArgumentNullException

partUri vagy contentType az null.

ArgumentException

partUri nem érvényes PackagePart egységes erőforrás-azonosító (URI).

InvalidOperationException

A megadott partUri rész már megtalálható a csomagban.

ArgumentOutOfRangeException

Az compressionOption érték érvénytelen.

ObjectDisposedException

A csomag nincs megnyitva (Dispose(Boolean) vagy Close() meghívva van).

IOException

A csomag írásvédett (új rész nem adható hozzá).

Példák

Az alábbi példa bemutatja, hogyan hozhat létre újat PackagePart , majd tárolhat adatokat a részbe.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Megjegyzések

Az alapértelmezett ZipPackage származtatott osztály esetében a CreatePart metódus csak két compressionOption értéket támogat, NotCompressed vagy Normal tömörítést. A , vagy a tömörítés egyéb CompressionOption értékeiMaximum.Normal SuperFast Fast

CreatePart üreset Stream hoz létre az új rész számára. Ez a PackagePart.GetStream módszer a részhez társított streampéldányra mutató hivatkozás lekérésére használható.

További információkért tekintse meg az Open Packaging Conventions (OPC) specifikációját, amely a következő címen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/tölthető le: .

Megjegyzések az öröklőkhöz

CreatePart(Uri, String, CompressionOption) belsőleg meghívja a származtatott osztály metódusát CreatePartCore(Uri, String, CompressionOption) , hogy ténylegesen hozza létre a részt a származtatott osztályban implementált fizikai formátum alapján.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?