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)
- ソース:
- 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
または 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)
- ソース:
- 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
または contentType
が null
です。
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 のその他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) メソッドを内部的に呼び出して、派生クラスに実装されている物理形式に基づいてパーツを実際に作成します。
こちらもご覧ください
適用対象
.NET