PackagePart.GetRelationship(String) 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

套件:

System.IO.Packaging v8.0.0

來源:

PackagePart.cs

傳回具有指定之 Id 的關聯性。

public:
 System::IO::Packaging::PackageRelationship ^ GetRelationship(System::String ^ id);

public System.IO.Packaging.PackageRelationship GetRelationship (string id);

member this.GetRelationship : string -> System.IO.Packaging.PackageRelationship

Public Function GetRelationship (id As String) As PackageRelationship

參數

id

String

要傳回之關聯性的 Id。

傳回

PackageRelationship

符合指定之 id 的關聯性。

例外狀況

ArgumentNullException

id 為 null。

XmlException

id 不是有效的 XML 識別項。

ArgumentException

relationshipType 為空字串。

InvalidOperationException

組件已經刪除。

-或-

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

-或-

套件中不存在具有指定之 id 的關聯性。

IOException

封裝是唯寫的 (無法讀取關聯性資訊)。

備註

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

您可以使用 RelationshipExists 方法來判斷與指定的 Id 關聯性是否由這個部分所擁有。

另請參閱

• CreateRelationship
• DeleteRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• RelationshipExists(String)