共用方式為


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

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

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

新組件的統一資源識別項 (URI)。

contentType
String

資料流的內容類型。

傳回

新建立的組件。

例外狀況

partUricontentTypenull

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

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

給繼承者的注意事項

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

資料流、NotCompressedNormal 壓縮的壓縮選項。

傳回

新建立的組件。

例外狀況

partUricontentTypenull

partUri 不是有效的 PackagePart 統一資源識別項 (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 方法僅支援兩 compressionOption 個值或 NotCompressedNormal 壓縮。 、、 其他CompressionOptionFastMaximum或使用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) 方法,根據衍生類別中實作的實體格式,實際建立元件。

另請參閱

適用於