PackagePart.CreateRelationship 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在此 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)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- 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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship参数
- targetUri
- Uri
目标部件的 URI。
- targetMode
- TargetMode
枚举值之一。 例如，如果目标部件位于 Package内，则 Internal;或 External 如果目标是 Package之外的资源。
- relationshipType
- String
关系的角色。
返回
此 PackagePart 与目标 PackagePart 或外部资源之间的部分级关系。
例外
targetUri 或 relationshipTypenull。
targetMode 参数不是有效的 TargetMode 枚举值。
包是只读的（无法添加新的关系）。
注解
部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。
源 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)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- 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);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.PackageRelationshipPublic 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。
返回
此 PackagePart 与目标 PackagePart 或外部资源之间的部分级关系。
例外
targetUri 或 relationshipTypenull。
targetMode 参数不是有效的 TargetMode 枚举值。
包是只读的（无法添加新的关系）。
注解
部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。
源 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)
- 开放打包约定规范
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈