Package.CreatePart 方法

定义

命名空间:
System.IO.Packaging
程序集:
System.IO.Packaging.dll
程序集:
WindowsBase.dll
程序集:
System.IO.Packaging.dll, WindowsBase.dll
包:
System.IO.Packaging v11.0.0-preview.4.26230.115

创建新的包部件。

重载

名称 说明
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 可用于获取对与部件关联的流实例的引用。

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

CreatePart(Uri, String)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
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

数据流的内容类型。

返回

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) 的方法，以基于派生类中实现的物理格式实际创建部件。

另请参阅

适用于

CreatePart(Uri, String, CompressionOption)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
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

数据流 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 值 NotCompressed 或 Normal 压缩。 其他CompressionOption值Maximum，Fast或使用SuperFastNormal压缩。

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

有关其他信息，请参阅可在以下位置 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/下载的开放打包约定 （OPC） 规范。

继承者说明

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

另请参阅

适用于