Package.CreatePart 方法

定义

创建新的包部件。

重载

CreatePart(Uri, String)

使用给定的 URI 和内容类型创建新的未压缩部件。

CreatePart(Uri, String, CompressionOption)

使用给定的 URI、内容类型和压缩选项创建新部件。

示例

以下示例演示如何创建新的 PackagePart ,然后将数据存储到 部件中。

// 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 初始化新部件的空 Stream 。 方法 PackagePart.GetStream 可用于获取对与 部件关联的流实例的引用。

有关包部件的详细信息,请参阅开放打包约定 (OPC) 规范的第 1.1 部分,可从 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/

CreatePart(Uri, String)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs

使用给定的 URI 和内容类型创建新的未压缩部件。

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

参数

partUri
Uri

新部件的统一资源标识符 (URI)。

contentType
String

数据流的内容类型。

返回

新创建的部件。

例外

partUricontentTypenull

partUri 不是有效的 PackagePart URI。

包中已存在具有指定的 partUri 的部件。

包未打开(已调用了 Dispose(Boolean)Close())。

包为只读的(无法添加新部件)。

示例

以下示例演示如何创建新的 PackagePart ,然后将数据存储到 部件中。

// 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 初始化新部件的空 Stream 。 方法 PackagePart.GetStream 可用于获取对与 部件关联的流实例的引用。

该部分 CompressionOptionCompressionOption.NotCompressed

有关包部件的其他信息,请参阅开放打包约定 (OPC) 规范中的第 1.1 部分,可从 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/

继承者说明

CreatePart(Uri, String) 在内部调用派生类的 CreatePartCore(Uri, String, CompressionOption) 方法,根据派生类中实现的物理格式实际创建部件。

另请参阅

适用于

CreatePart(Uri, String, CompressionOption)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs

使用给定的 URI、内容类型和压缩选项创建新部件。

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

参数

partUri
Uri

新部件的 URI。

contentType
String

数据流的内容类型。

compressionOption
CompressionOption

数据流的压缩选项、NotCompressedNormal 压缩。

返回

新创建的部件。

例外

partUricontentTypenull

partUri 不是有效的 PackagePart 统一资源标识符 (URI)。

包中已存在具有指定的 partUri 的部件。

compressionOption 值无效。

包未打开(已调用了 Dispose(Boolean)Close())。

包为只读的(无法添加新部件)。

示例

以下示例演示如何创建新的 PackagePart ,然后将数据存储到 部件中。

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

注解

对于默认 ZipPackage 派生类, CreatePart 方法仅支持两个 compressionOption 值或 NotCompressedNormal 压缩。 、 FastSuperFast 的其他CompressionOptionMaximum使用Normal压缩。

CreatePart 为新部件创建空 Stream 。 方法 PackagePart.GetStream 可用于获取对与 部件关联的流实例的引用。

有关其他信息,请参阅开放打包约定 (OPC) 规范,可从 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/

继承者说明

CreatePart(Uri, String, CompressionOption) 在内部调用派生类的 CreatePartCore(Uri, String, CompressionOption) 方法,根据派生类中实现的物理格式实际创建部件。

另请参阅

适用于