Package.CreatePart Metodo
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una parte del pacchetto nuova.
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. |
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.
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/.
- 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, 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
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.
' 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
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 |
- 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, 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
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.
' 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
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 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: