PackagePart.CreateRelationship 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

套件:

System.IO.Packaging v8.0.0

建立這個 PackagePart 和指定目標 PackagePart 或外部資源之間的組件層級關係。

多載

CreateRelationship(Uri, TargetMode, String)	建立這個 PackagePart 和指定目標 PackagePart 或外部資源之間的組件層級關係。
CreateRelationship(Uri, TargetMode, String, String)	建立這個 PackagePart 和指定目標 PackagePart 或外部資源之間的組件層級關係。

備註

元件層級關聯性會定義此元件與目標群組件或資源之間的關聯。 部分層級關聯性可以是兩種形式之一。

• 在 內的目標來源 PackagePartPackagePartPackage 之間。

• 在套件外部的目標資源來源 PackagePart 之間。

在部分關聯性中，來源元件會被視為關聯性的「擁有者」。 刪除來源元件時，也會刪除元件所擁有的所有關聯性。 建立或刪除關聯性的程式不會以任何方式實際改變目標群組件或資源。

方法 CreateRelationship 不會以任何方式實際變更來源元件或目標群組件或資源。

關聯性的目標不能是另一個關聯性。

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

如需 XPS 檔的詳細資訊，請參閱 可在 下載 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ 的 Open XML Paper Specification (XPS) 。

CreateRelationship(Uri, TargetMode, String)

來源:

PackagePart.cs

建立這個 PackagePart 和指定目標 PackagePart 或外部資源之間的組件層級關係。

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship

參數

targetUri

Uri

目標組件的 URI。

targetMode

TargetMode

其中一個列舉值。 例如，如果目標組件位於 Internal 內部，就是 Package，如果目標組件是 External 外部的資源，就是 Package。

relationshipType

String

關聯性的角色。

傳回

PackageRelationship

這個 PackagePart 與目標 PackagePart 或外部資源之間的組件層級關係。

例外狀況

InvalidOperationException

組件已經刪除。

-或-

Package 沒有開啟 (已經呼叫 Dispose(Boolean) 或 Close())。

ArgumentNullException

targetUri 或 relationshipType 為 null。

ArgumentOutOfRangeException

targetMode 參數不是有效的 TargetMode 列舉值。

ArgumentException

由 targetUri 識別的組件是一種關聯性 (關聯性的目標不能是另一種關聯性)。

-或-

targetMode 是以 Internal 的形式指定，但 targetUri 是絕對外部 URI。

IOException

套件是唯讀的 (無法新增關聯性)。

備註

元件層級關聯性會定義此元件與目標群組件或資源之間的關聯。 部分層級關聯性可以是兩種形式之一。

• 在 內的目標來源 PackagePartPackagePartPackage 之間。

• 在套件外部的目標資源來源 PackagePart 之間。

在部分關聯性中，來源元件會被視為關聯性的「擁有者」。 刪除來源元件時，也會刪除元件所擁有的所有關聯性。 建立或刪除關聯性的程式不會以任何方式實際改變目標群組件或資源。

方法 CreateRelationship 不會以任何方式實際變更來源元件或目標群組件或資源。

關聯性的目標不能是另一個關聯性。

如果 targetMode 指定為 Internal ， targetUri 則必須根據 RFC 3986統一資源識別項 (URI) 一般語法 規格來形成相對 URI。 內部相對 URI 可以是以正斜線開頭的絕對路徑， (「/」) 字元，例如 「/page1.xaml」 或 「/images/picture4.jpg」，或 「.. 等相對路徑。/imagespicture1.jpg「，針對封裝根目錄 (」/「) 解析為基底 URI。

如果 targetMode 指定為 External ， targetUri 則可以是根據 RFC 3986統一資源識別項 (URI) 一般語法 規格來形成絕對或相對 URI。 "https://www.microsoft.com/page2.xml" 是參考外部目標資源 「page2.xml」 的絕對 URI 範例。 「images/picture1.jpg」 是相對 URI 的範例，它也會參考外部目標資源 「1.jpg」，但會根據封裝本身的 URI 解析。

relationshipType 必須是根據 RFC 3986統一資源識別元 (URI) 一般語法 規格所構成的 URI。 不同的封裝類型可以定義不同的部分層級關聯性類型。 下表顯示針對符合Open XML Paper Specification (XPS) 的檔所定義的部分層級 relationshipType URI。

XPS 檔 Part-Level 關聯性	關聯性類型 URI
數位簽章定義	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure	http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
必要資源	http://schemas.microsoft.com/xps/2005/06/required-resource
限制字型	http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

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

如需 XPS 檔的詳細資訊，請參閱 可在 下載 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ 的Open XML Paper Specification (XPS) 。

另請參閱

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 開放式封裝慣例規格

CreateRelationship(Uri, TargetMode, String, String)

來源:

PackagePart.cs

建立這個 PackagePart 和指定目標 PackagePart 或外部資源之間的組件層級關係。

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType, System::String ^ id);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string? id);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship

參數

targetUri

Uri

目標組件的 URI。

targetMode

TargetMode

其中一個列舉值。 例如，如果目標組件位於 Internal 內部，就是 Package，如果目標組件是 External 外部的資源，就是 Package。

relationshipType

String

關聯性的角色。

id

String

關聯性的唯一 ID。

傳回

PackageRelationship

這個 PackagePart 與目標 PackagePart 或外部資源之間的組件層級關係。

例外狀況

InvalidOperationException

組件已經刪除。

-或-

Package 沒有開啟 (已經呼叫 Dispose(Boolean) 或 Close())。

ArgumentNullException

targetUri 或 relationshipType 為 null。

ArgumentOutOfRangeException

targetMode 參數不是有效的 TargetMode 列舉值。

ArgumentException

由 targetUri 識別的組件是一種關聯性 (關聯性的目標不能是另一種關聯性)。

-或-

targetMode 是以 Internal 的形式指定，但 targetUri 是絕對外部 URI。

IOException

套件是唯讀的 (無法新增關聯性)。

XmlException

id 不是有效的 XML 識別項。

-或-

具有指定之 id 的組件已經存在。

備註

元件層級關聯性會定義此元件與目標群組件或資源之間的關聯。 部分層級關聯性可以是兩種形式之一。

• 在 內的目標來源 PackagePartPackagePartPackage 之間。

• 在套件外部的目標資源來源 PackagePart 之間。

在部分關聯性中，來源元件會被視為關聯性的「擁有者」。 刪除來源元件時，也會刪除元件所擁有的所有關聯性。 建立或刪除關聯性的程式不會以任何方式實際改變目標群組件或資源。

id 必須是有效的 XML 識別碼。 此 id 類型為 xsd：ID，且必須遵循 XML 架構第 2 部分：資料類型 規格中指定的命名慣例， (請參閱 https://www.w3.org/TR/xmlschema-2/#ID) 。

方法 CreateRelationship 不會以任何方式實際變更來源元件或目標群組件或資源。

關聯性的目標不能是另一個關聯性。

如果 targetMode 指定為 Internal ， targetUri 則必須根據 RFC 3986統一資源識別項 (URI) 一般語法 規格來形成相對 URI。 內部相對 URI 可以是以正斜線開頭的絕對路徑， (「/」) 字元，例如 「/page1.xaml」 或 「/images/picture4.jpg」，或 「.. 等相對路徑。/imagespicture1.jpg「，針對封裝根目錄 (」/「) 解析為基底 URI。

如果 targetMode 指定為 External ， targetUri 則可以是根據 RFC 3986統一資源識別項 (URI) 一般語法 規格來形成絕對或相對 URI。 "https://www.microsoft.com/page2.xml"是參考外部目標資源 「page2.xml」 的絕對 URI 範例。 「images/picture1.jpg」 是相對 URI 的範例，它也會參考外部目標資源 「1.jpg」，但會根據封裝本身的 URI 解析。

relationshipType 必須是根據 RFC 3986統一資源識別元 (URI) 一般語法 規格所構成的 URI。 不同的封裝類型可以定義不同的部分層級關聯性類型。 下表顯示針對符合Open XML Paper Specification (XPS) 的檔所定義的部分層級 relationshipType URI。

XPS 檔 Part-Level 關聯性	關聯性類型 URI
數位簽章定義	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure	http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
必要資源	http://schemas.microsoft.com/xps/2005/06/required-resource
限制字型	http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

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

如需 XPS 檔的詳細資訊，請參閱 可在 下載 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ 的Open XML Paper Specification (XPS) 。

另請參閱

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 開放式封裝慣例規格