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 或外部资源之间的部分级关系。

注解

部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。

• 在 源PackagePart到 内Package的目标PackagePart之间。

• 在源 PackagePart 到包外部的目标资源之间。

在部件关系中，源部件被视为关系的“所有者”。 删除源部件时，也会删除该部件拥有的所有关系。 创建或删除关系的过程不会以任何方式以物理方式改变目标部件或资源。

方法 CreateRelationship 不会以任何方式物理更改源部件、目标部件或资源。

关系的目标不能是另一个关系。

有关包关系的详细信息，请参阅开放 打包约定 (OPC) 规范的第 1.3 节，可在 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/。

有关 XPS 文档的详细信息，请参阅 Open XML Paper Specification (XPS) ，可从 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下载。

CreateRelationship(Uri, TargetMode, String)

Source:

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

包是只读的（无法添加新关系）。

注解

部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。

• 在 中的源PackagePart与目标PackagePartPackage之间。

• 在源 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 或相对 URI。 "https://www.microsoft.com/page2.xml" 是引用外部目标资源“page2.xml”的绝对 URI 的示例。 “images/picture1.jpg”是相对 URI 的一个示例，该 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

有关包关系的详细信息，请参阅开放 打包约定 (OPC) 规范的第 1.3 部分，可从 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/。

有关 XPS 文档的详细信息，请参阅 Open XML 纸张规范 (XPS) ，可从 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下载。

另请参阅

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 开放打包约定规范

CreateRelationship(Uri, TargetMode, String, String)

Source:

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 的部分。

注解

部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。

• 在 中的源PackagePart与目标PackagePartPackage之间。

• 在源 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 或相对 URI。 "https://www.microsoft.com/page2.xml"是引用外部目标资源“page2.xml”的绝对 URI 的示例。 “images/picture1.jpg”是相对 URI 的一个示例，该 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

有关包关系的详细信息，请参阅开放 打包约定 (OPC) 规范的第 1.3 部分，可从 下载 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/。

有关 XPS 文档的详细信息，请参阅 Open XML 纸张规范 (XPS) ，请参阅 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/。

另请参阅

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• 开放打包约定规范