Package.CreatePart Metod

Definition

Namnområde:: System.IO.Packaging

Sammansättning:: WindowsBase.dll

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 paketdel.

Överlagringar

Name	Description
CreatePart(Uri, String)	Skapar en ny okomprimerad del med en viss URI och innehållstyp.
CreatePart(Uri, String, CompressionOption)	Skapar en ny del med en viss URI, innehållstyp och komprimeringsalternativ.

Exempel

I följande exempel visas hur du skapar en ny PackagePart och sedan lagrar data i delen.

// 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.

Kommentarer

CreatePart initierar en tom Stream för den nya delen. Metoden PackagePart.GetStream kan användas för att hämta en referens till den ströminstans som är associerad med delen.

Mer information om paketdelar finns i avsnitt 1.1 i OPC-specifikationen (Open Packaging Conventions) som är tillgänglig för nedladdning på https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Skapar en ny okomprimerad del med en viss URI och innehållstyp.

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

Parametrar

partUri: Uri

Den nya delens enhetliga resursidentifierare (URI).

contentType: String

Dataströmmens innehållstyp.

Returer

PackagePart

Den nya skapade delen.

Undantag

ArgumentNullException

partUri eller contentType är null.

ArgumentException

partUri är inte en giltig PackagePart URI.

InvalidOperationException

En del med angiven partUri finns redan i paketet.

ObjectDisposedException

Paketet är inte öppet (Dispose(Boolean) eller Close() har anropats).

IOException

Paketet är skrivskyddat (det går inte att lägga till en ny del).

Exempel

I följande exempel visas hur du skapar en ny PackagePart och sedan lagrar data i delen.

// 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.

Kommentarer

CreatePart initierar en tom Stream för den nya delen. Metoden PackagePart.GetStream kan användas för att hämta en referens till den ströminstans som är associerad med delen.

Delen CompressionOption är CompressionOption.NotCompressed.

Anteckningar till arvingar

CreatePart(Uri, String) anropar internt den härledda klassens CreatePartCore(Uri, String, CompressionOption) metod för att faktiskt skapa delen baserat på det fysiska format som implementeras i den härledda klassen.

Se även

Gäller för

CreatePart(Uri, String, CompressionOption)

Skapar en ny del med en viss URI, innehållstyp och komprimeringsalternativ.

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

Parametrar

partUri: Uri

URI:n för den nya delen.

contentType: String

Dataströmmens innehållstyp.

compressionOption: CompressionOption

Komprimeringsalternativet för dataströmmen NotCompressed eller Normal komprimering.

Returer

PackagePart

Den nya skapade delen.

Undantag

ArgumentNullException

partUri eller contentType är null.

ArgumentException

partUri är inte en giltig PackagePart URI (uniform resource identifier).

InvalidOperationException

En del med angiven partUri finns redan i paketet.

ArgumentOutOfRangeException

Värdet compressionOption är inte giltigt.

ObjectDisposedException

Paketet är inte öppet (Dispose(Boolean) eller Close() har anropats).

IOException

Paketet är skrivskyddat (det går inte att lägga till en ny del).

Exempel

I följande exempel visas hur du skapar en ny PackagePart och sedan lagrar data i delen.

// 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.

Kommentarer

För den härledda standardklassen ZipPackage CreatePart stöder metoden endast två compressionOption värden eller NotCompressed Normal komprimering. Andra CompressionOption värden för Maximum, Fasteller SuperFast använd Normal komprimering.

CreatePart skapar en tom Stream för den nya delen. Metoden PackagePart.GetStream kan användas för att hämta en referens till den ströminstans som är associerad med delen.

Mer information finns i OPC-specifikationen (Open Packaging Conventions) som är tillgänglig för nedladdning på https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Anteckningar till arvingar

CreatePart(Uri, String, CompressionOption) anropar internt den härledda klassens CreatePartCore(Uri, String, CompressionOption) metod för att faktiskt skapa delen baserat på det fysiska format som implementeras i den härledda klassen.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?