PackagePart.CreateRelationship 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
建立這個 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 和指定目標 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
關聯性的角色。
傳回
這個 PackagePart 與目標 PackagePart 或外部資源之間的組件層級關係。
例外狀況
targetUri
或 relationshipType
為 null
。
targetMode
參數不是有效的 TargetMode 列舉值。
套件是唯讀的 (無法新增關聯性)。
備註
元件層級關聯性會定義此元件與目標群組件或資源之間的關聯。 部分層級關聯性可以是兩種形式之一。
在 內的目標來源 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 和指定目標 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
其中一個列舉值。 例如,如果目標組件位於 Internal 內部,就是 Package,如果目標組件是 External 外部的資源,就是 Package。
- relationshipType
- String
關聯性的角色。
- id
- String
關聯性的唯一 ID。
傳回
這個 PackagePart 與目標 PackagePart 或外部資源之間的組件層級關係。
例外狀況
targetUri
或 relationshipType
為 null
。
targetMode
參數不是有效的 TargetMode 列舉值。
套件是唯讀的 (無法新增關聯性)。
備註
元件層級關聯性會定義此元件與目標群組件或資源之間的關聯。 部分層級關聯性可以是兩種形式之一。
在 內的目標來源 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)
- 開放式封裝慣例規格
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應