Package.CreatePart Metodo
Definizione
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 nuova parte del pacchetto.
Overload
| Nome | Descrizione |
|---|---|
| CreatePart(Uri, String) |
Crea una nuova parte non compressa con un determinato URI e tipo di contenuto. |
| CreatePart(Uri, String, CompressionOption) |
Crea una nuova parte con un determinato URI, tipo di contenuto e 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 del 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 all'indirizzo 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
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
Crea una nuova parte non compressa con un determinato URI e 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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartParametri
- partUri
- Uri
URI (Uniform Resource Identifier) della nuova parte.
- contentType
- String
Tipo di contenuto del flusso di dati.
Valori restituiti
Nuova parte creata.
Eccezioni
partUri o contentType è null.
partUri non è un URI valido PackagePart .
Una parte con l'oggetto specificato partUri è già presente nel pacchetto.
Il pacchetto non è aperto (Dispose(Boolean) o Close() è stato chiamato ).
Il pacchetto è di sola lettura (non è possibile aggiungere una nuova parte).
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 del 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 all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Note per gli eredi
CreatePart(Uri, String) internamente chiama 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
CreatePart(Uri, String, CompressionOption)
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
- Origine:
- Package.cs
Crea una nuova parte con un determinato URI, tipo di contenuto e 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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartParametri
- partUri
- Uri
URI della nuova parte.
- contentType
- String
Tipo di contenuto del flusso di dati.
- compressionOption
- CompressionOption
Opzione di compressione per il flusso NotCompressed di dati o Normal la compressione.
Valori restituiti
Nuova parte creata.
Eccezioni
partUri o contentType è null.
partUri non è un URI (Uniform Resource Identifier) valido PackagePart .
Una parte con l'oggetto specificato partUri è già presente nel pacchetto.
Il compressionOption valore non è valido.
Il pacchetto non è aperto (Dispose(Boolean) o Close() è stato chiamato ).
Il pacchetto è di sola lettura (non è possibile aggiungere una nuova parte).
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 la Normal compressione.
CreatePart crea un oggetto vuoto Stream per la nuova parte. Il PackagePart.GetStream metodo può essere usato per ottenere un riferimento all'istanza del flusso associata alla parte.
Per altre informazioni, vedere la specifica Open Packaging Conventions (OPC) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Note per gli eredi
CreatePart(Uri, String, CompressionOption) internamente chiama il metodo della CreatePartCore(Uri, String, CompressionOption) classe derivata per creare effettivamente la parte in base al formato fisico implementato nella classe derivata.
