Package.CreatePart 方法

定义

命名空间:

System.IO.Packaging

程序集:

System.IO.Packaging.dll

包:

System.IO.Packaging v8.0.0

创建新的包部件。

重载

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

使用给定的 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

数据流的内容类型。

返回

PackagePart

新创建的部件。

例外

ArgumentNullException

partUri 或 contentType 为 null。

ArgumentException

partUri 不是有效的 PackagePart URI。

InvalidOperationException

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

ObjectDisposedException

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

IOException

包为只读的（无法添加新部件）。

示例

以下示例演示如何创建新的 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 可用于获取对与部件关联的流实例的引用。

该部分 CompressionOption 为 CompressionOption.NotCompressed。

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

继承者说明

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

另请参阅

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

CreatePart(Uri, String, CompressionOption)

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

数据流的压缩选项、NotCompressed 或 Normal 压缩。

返回

PackagePart

新创建的部件。

例外

ArgumentNullException

partUri 或 contentType 为 null。

ArgumentException

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

InvalidOperationException

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

ArgumentOutOfRangeException

compressionOption 值无效。

ObjectDisposedException

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

IOException

包为只读的（无法添加新部件）。

示例

以下示例演示如何创建新的 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 压缩。 、 Fast或 SuperFast 的其他CompressionOption值Maximum使用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) 方法，根据派生类中实现的物理格式实际创建部件。

另请参阅

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