Package.CreatePart Metodo

Definizione

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.

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
Origine:
Package.cs
Origine:
Package.cs
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, string contentType);

Parametri

partUri
Uri

URI (Uniform Resource Identifier) della nuova parte.

contentType
String

Il tipo di contenuto del flusso di dati.

Restituisce

La nuova parte creata.

Eccezioni

partUri o contentType è null.

partUri non è un URI PackagePart valido.

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

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

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.

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

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

CreatePart(Uri, String, CompressionOption)

Origine:
Package.cs
Origine:
Package.cs
Origine:
Package.cs
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, string contentType, System.IO.Packaging.CompressionOption compressionOption);

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

La nuova parte creata.

Eccezioni

partUri o contentType è null.

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

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

Il valore compressionOption non è valido.

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

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.

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

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9