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 使用して、パーツに関連付けられているストリーム インスタンスへの参照を取得できます。

パッケージ パーツの詳細については、 で https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ダウンロードできる Open Packaging Conventions (OPC) 仕様のセクション 1.1 を参照してください。

CreatePart(Uri, String)

ソース:
Package.cs
ソース:
Package.cs
ソース:
Package.cs
ソース:
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

新しいパーツの Uniform Resource Identifier (URI)。

contentType
String

データ ストリームのコンテンツ タイプ。

戻り値

新規作成されたパーツ。

例外

partUri または contentTypenull です。

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 使用して、パーツに関連付けられているストリーム インスタンスへの参照を取得できます。

部分 CompressionOption は です CompressionOption.NotCompressed

パッケージ パーツの詳細については、でダウンロード https://www.ecma-international.org/publications-and-standards/standards/ecma-376/できる Open Packaging Conventions (OPC) 仕様のセクション 1.1 を参照してください。

注意 (継承者)

CreatePart(Uri, String) 派生クラスの CreatePartCore(Uri, String, CompressionOption) メソッドを内部的に呼び出して、派生クラスに実装されている物理形式に基づいてパーツを実際に作成します。

こちらもご覧ください

適用対象

CreatePart(Uri, String, CompressionOption)

ソース:
Package.cs
ソース:
Package.cs
ソース:
Package.cs
ソース:
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 圧縮。

戻り値

新規作成されたパーツ。

例外

partUri または contentTypenull です。

partUri が有効な PackagePart Uniform Resource Identifier (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 2 つの compressionOption 値 ( NotCompressed 圧縮 Normal ) のみをサポートします。 、、または SuperFast のその他CompressionOptionMaximum値は圧縮を使用Normalします。 Fast

CreatePart は、新しいパーツの空 Stream の を作成します。 メソッドを PackagePart.GetStream 使用して、パーツに関連付けられているストリーム インスタンスへの参照を取得できます。

詳細については、 でダウンロード https://www.ecma-international.org/publications-and-standards/standards/ecma-376/できる Open Packaging Conventions (OPC) 仕様を参照してください。

注意 (継承者)

CreatePart(Uri, String, CompressionOption) 派生クラスの CreatePartCore(Uri, String, CompressionOption) メソッドを内部的に呼び出して、派生クラスに実装されている物理形式に基づいてパーツを実際に作成します。

こちらもご覧ください

適用対象