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 方法不会以任何方式以物理方式更改源部件或目标部件或资源。

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

有关包关系的详细信息，请参阅 开放打包约定（OPC） 规范的第 1.3 部分，这些规范可在 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 纸张规范（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;或 External 如果目标是 Package之外的资源。

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 可以是一个绝对或相对 URI，根据 RFC 3986统一资源标识符（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 文档的详细信息，请参阅 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下载的 Open XML 纸张规范 （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;或 External 如果目标是 Package之外的资源。

relationshipType

String

关系的角色。

id

String

关系的唯一 ID。

返回

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 可以是一个绝对或相对 URI，根据 RFC 3986统一资源标识符（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 文档的详细信息，请参阅 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下载的 Open XML 纸张规范 （XPS）。

另请参阅

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