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

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

CreatePart(Uri, String)

ソース:

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

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

戻り値

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。

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

注意 (継承者)

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

こちらもご覧ください

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

CreatePart(Uri, String, CompressionOption)

ソース:

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 Uniform Resource Identifier (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 2 つの compressionOption 値 ( NotCompressed 圧縮 Normal ) のみをサポートします。 、、または SuperFast のその他CompressionOptionのMaximum値は圧縮を使用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) メソッドを内部的に呼び出して、派生クラスに実装されている物理形式に基づいてパーツを実際に作成します。

こちらもご覧ください

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