PackagePart.CreateRelationship 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

建立這個 PackagePart 與指定目標 PackagePart 或外部資源之間的部分層級關聯性。

多載

CreateRelationship(Uri, TargetMode, String)	建立這個 PackagePart 與指定目標 PackagePart 或外部資源之間的部分層級關聯性。
CreateRelationship(Uri, TargetMode, String, String)	建立這個 PackagePart 與指定目標 PackagePart 或外部資源之間的部分層級關聯性。

備註

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

• 在來源 PackagePart 到 Package內的目標 PackagePart 之間。

• 在來源 PackagePart 封裝外部的目標資源之間。

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

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

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

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

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

CreateRelationship(Uri, TargetMode, String)

建立這個 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

其中一個列舉值。 例如，如果目標元件位於 Package內，Internal ;如果目標是 Package以外的資源，則為 External。

relationshipType

String

關聯性的角色。

傳回

PackageRelationship

這個 PackagePart 與目標 PackagePart 或外部資源之間的部分層級關聯性。

例外狀況

InvalidOperationException

元件已刪除。

-或-

Package 尚未開啟（已呼叫Dispose(Boolean) 或 Close()）。

ArgumentNullException

targetUri 或 relationshipTypenull。

ArgumentOutOfRangeException

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

ArgumentException

targetUri 所識別的部分是關聯性（關聯性的目標不能是另一個關聯性）。

-或-

targetMode 指定為 Internal，但 targetUri 是絕對外部 URI。

IOException

封裝是唯讀的（無法新增關聯性）。

備註

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

• 在來源 PackagePart 到 Package內的目標 PackagePart 之間。

• 在來源 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 紙張規格 （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

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

如需 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 與指定目標 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

其中一個列舉值。 例如，如果目標元件位於 Package內，Internal ;如果目標是 Package以外的資源，則為 External。

relationshipType

String

關聯性的角色。

id

String

關聯性的唯一標識碼。

傳回

PackageRelationship

這個 PackagePart 與目標 PackagePart 或外部資源之間的部分層級關聯性。

例外狀況

InvalidOperationException

元件已刪除。

-或-

Package 尚未開啟（已呼叫Dispose(Boolean) 或 Close()）。

ArgumentNullException

targetUri 或 relationshipTypenull。

ArgumentOutOfRangeException

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

ArgumentException

targetUri 所識別的部分是關聯性（關聯性的目標不能是另一個關聯性）。

-或-

targetMode 指定為 Internal，但 targetUri 是絕對外部 URI。

IOException

封裝是唯讀的（無法新增關聯性）。

XmlException

id 不是有效的 XML 識別碼。

-或-

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

備註

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

• 在來源 PackagePart 到 Package內的目標 PackagePart 之間。

• 在來源 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 紙張規格 （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

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

如需 XPS 檔的詳細資訊，請參閱 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下載的 Open XML 紙張規格 （XPS）。

另請參閱

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