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 可用來取得與元件相關聯之數據流實例的參考。

如需套件元件的詳細資訊，請參閱開放封裝慣例 (OPC) 規格的 1.1 節，以下載 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/。

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

新組件的統一資源識別項 (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) 方法，根據衍生類別中實作的實體格式，實際建立元件。

另請參閱

• 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 統一資源識別項 (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 個值或 NotCompressedNormal 壓縮。 、、 其他CompressionOption值FastMaximum或使用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) 方法，根據衍生類別中實作的實體格式，實際建立元件。

另請參閱

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