Package.CreatePart メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
新しいパッケージ パーツを作成します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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)
指定された 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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartパラメーター
- partUri
- Uri
新しいパーツの UNIFORM Resource Identifier (URI)。
- contentType
- String
データ ストリームのコンテンツ タイプ。
返品
新しく作成されたパーツ。
例外
partUri または contentType が null。
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)
特定の 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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartパラメーター
- partUri
- Uri
新しいパーツの URI。
- contentType
- String
データ ストリームのコンテンツ タイプ。
- compressionOption
- CompressionOption
データ ストリーム、 NotCompressed 、または Normal 圧縮の圧縮オプション。
返品
新しく作成されたパーツ。
例外
partUri または contentType が null。
partUri が有効な PackagePart URI (uniform resource identifier) ではありません。
指定した 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 圧縮) のみをサポートします。
Maximum、Fast、またはSuperFastの他のCompressionOption値は、Normal圧縮を使用します。
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) メソッドを内部的に呼び出して、派生クラスに実装されている物理形式に基づいてパーツを実際に作成します。