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 文档的详细信息,请参阅 Open XML Paper Specification (XPS) ,可从 https://www.ecma-international.org/publications-and-standards/standards/ecma-388/下载。
CreateRelationship(Uri, TargetMode, String)
- 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.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 枚举值。
包是只读的(无法添加新关系)。
注解
部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。
在 中的源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
- 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.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 枚举值。
包是只读的(无法添加新关系)。
注解
部件级关系定义此部件与目标部件或资源之间的关联。 部件级关系可以是两种形式之一。
在 中的源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)
- 开放打包约定规范
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈