共用方式為


PackagePart.CreateRelationship 方法

定義

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

多載

CreateRelationship(Uri, TargetMode, String)

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

CreateRelationship(Uri, TargetMode, String, String)

建立這個 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.cs
來源:
PackagePart.cs
來源:
PackagePart.cs
來源:
PackagePart.cs
來源:
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

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

relationshipType
String

關聯性的角色。

傳回

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

例外狀況

元件已刪除。

-或-

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

targetUrirelationshipTypenull

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

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

-或-

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

封裝是唯讀的(無法新增關聯性)。

備註

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

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

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

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

如果 targetMode 指定為 InternaltargetUri 必須是根據 RFC 3986統一資源識別元 (URI) 一般語法 規格所形成的相對 URI。 內部相對 URI 可以是以正斜線 (“/”) 字元開頭的絕對路徑,例如 “/page1.xaml” 或 “/images/picture4.jpg”,或相對路徑,例如 “.. 。/imagespicture1.jpg會解析成基底 URI 的套件根目錄 (“/”) 。

如果 targetMode 指定為 ExternaltargetUri 可以是根據 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(Uri, TargetMode, String, String)

來源:
PackagePart.cs
來源:
PackagePart.cs
來源:
PackagePart.cs
來源:
PackagePart.cs
來源:
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);
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

關聯性的唯一標識碼。

傳回

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

例外狀況

元件已刪除。

-或-

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

targetUrirelationshipTypenull

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

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

-或-

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

封裝是唯讀的(無法新增關聯性)。

id 不是有效的 XML 識別碼。

-或-

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

備註

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

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

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

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

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

如果 targetMode 指定為 InternaltargetUri 必須是根據 RFC 3986統一資源識別元 (URI) 一般語法 規格所形成的相對 URI。 內部相對 URI 可以是以正斜線 (“/”) 字元開頭的絕對路徑,例如 “/page1.xaml” 或 “/images/picture4.jpg”,或相對路徑,例如 “.. 。/imagespicture1.jpg會解析成基底 URI 的套件根目錄 (“/”) 。

如果 targetMode 指定為 ExternaltargetUri 可以是根據 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)

另請參閱

適用於