Package.CreatePart Metodo

Definizione

Spazio dei nomi:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Pacchetto:

System.IO.Packaging v9.0.0-preview.3.24172.9

Crea una parte del pacchetto nuova.

Overload

CreatePart(Uri, String)	Crea una parte non compressa nuova con un URI specificato e un tipo di contenuto.
CreatePart(Uri, String, CompressionOption)	Crea una parte nuova con un URI specificato, un tipo di contenuto e un'opzione di compressione.

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo PackagePart e quindi archiviare i dati nella parte.

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

Commenti

CreatePart inizializza un oggetto vuoto Stream per la nuova parte. Il PackagePart.GetStream metodo può essere usato per ottenere un riferimento all'istanza di flusso associata alla parte.

Per altre informazioni sulle parti del pacchetto, vedere la sezione 1.1 della specifica Open Packaging Conventions (OPC) disponibile per il download in https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Origine:

Package.cs

Crea una parte non compressa nuova con un URI specificato e un tipo di contenuto.

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

Parametri

partUri

Uri

URI (Uniform Resource Identifier) della nuova parte.

contentType

String

Il tipo di contenuto del flusso di dati.

Restituisce

PackagePart

La nuova parte creata.

Eccezioni

ArgumentNullException

partUri o contentType è null.

ArgumentException

partUri non è un URI PackagePart valido.

InvalidOperationException

Una parte con partUri specificato è già presente nel pacchetto.

ObjectDisposedException

Il pacchetto non è aperto (Dispose(Boolean) o Close() è stato chiamato).

IOException

Il pacchetto è di sola lettura (impossibile aggiungere una parte nuova).

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo PackagePart e quindi archiviare i dati nella parte.

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

Commenti

CreatePart inizializza un oggetto vuoto Stream per la nuova parte. Il PackagePart.GetStream metodo può essere usato per ottenere un riferimento all'istanza di flusso associata alla parte.

La parte CompressionOption è CompressionOption.NotCompressed.

Per altre informazioni sulle parti del pacchetto, vedere la sezione 1.1 nella specifica Open Packaging Conventions (OPC) disponibile per il download in https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Note per gli eredi

CreatePart(Uri, String) chiama internamente il metodo della CreatePartCore(Uri, String, CompressionOption) classe derivata per creare effettivamente la parte in base al formato fisico implementato nella classe derivata.

Vedi anche

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart

CreatePart(Uri, String, CompressionOption)

Origine:

Package.cs

Crea una parte nuova con un URI specificato, un tipo di contenuto e un'opzione di compressione.

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

Parametri

partUri

Uri

URI della nuova parte.

contentType

String

Il tipo di contenuto del flusso di dati.

compressionOption

CompressionOption

L'opzione di compressione per il flusso di dati, compressione NotCompressed o Normal.

Restituisce

PackagePart

La nuova parte creata.

Eccezioni

ArgumentNullException

partUri o contentType è null.

ArgumentException

partUri non è un URI (Uniform Resource Identifier) PackagePart valido.

InvalidOperationException

Una parte con partUri specificato è già presente nel pacchetto.

ArgumentOutOfRangeException

Il valore compressionOption non è valido.

ObjectDisposedException

Il pacchetto non è aperto (Dispose(Boolean) o Close() è stato chiamato).

IOException

Il pacchetto è di sola lettura (impossibile aggiungere una parte nuova).

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo PackagePart e quindi archiviare i dati nella parte.

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

Commenti

Per la classe derivata predefinita ZipPackage , il CreatePart metodo supporta solo due compressionOption valori NotCompressed o Normal compressione. Altri CompressionOption valori di Maximum, Fasto SuperFast usano Normal la compressione.

CreatePart crea un vuoto Stream per la nuova parte. Il PackagePart.GetStream metodo può essere usato per ottenere un riferimento all'istanza di flusso associata alla parte.

Per altre informazioni, vedere la specifica Open Packaging Conventions (OPC) disponibile per il download in https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Note per gli eredi

CreatePart(Uri, String, CompressionOption) chiama internamente il metodo della CreatePartCore(Uri, String, CompressionOption) classe derivata per creare effettivamente la parte in base al formato fisico implementato nella classe derivata.

Vedi anche

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart