Интерфейс IOpcRelationship (msopc.h)

Статья
02/29/2024

Представляет связь между источником, который является частью или пакетом, и целевым объектом. Целью связи может быть часть или внешний ресурс.

Наследование

Интерфейс IOpcRelationship наследуется от интерфейса IUnknown . IOpcRelationship также имеет следующие типы элементов:

Методы

Интерфейс IOpcRelationship содержит следующие методы.


IOpcRelationship::GetId Возвращает уникальный идентификатор связи.
IOpcRelationship::GetRelationshipType Возвращает тип связи.
IOpcRelationship::GetSourceUri Возвращает универсальный код ресурса (URI) источника связи.
IOpcRelationship::GetTargetMode Возвращает значение, описывающее, является ли целевой объект связи внутренним или внешним по отношению к пакету.
IOpcRelationship::GetTargetUri Возвращает универсальный код ресурса (URI) целевого объекта связи.

Чтобы создать объект связи, представляющий связь, вызовите метод IOpcRelationshipSet::CreateRelationship . Чтобы получить указатель на интерфейс объекта связи, который представляет существующую связь, вызовите метод IOpcRelationshipSet::GetRelationship или IOpcRelationshipEnumerator::GetCurrent .

Пример разметки связи для связи, предназначенной для части:

<Relationship Id="rId1"
    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
    Target="word/document.xml" />

Использование типа связи (атрибут Type элемента Relationship ) является окончательным способом поиска части в пакете. Дополнительные сведения о том, почему используется тип связи, см. в разделе Общие сведения о частях. Пример использования типа связи для поиска части см. в разделе Поиск части основных свойств.

Допустимые идентификаторы для связей соответствуют ограничениям для xsd:ID, которые описаны в разделе 3.3.8 Идентификатор рекомендации W3C, схема XML, часть 2. Типы данных второго выпуска (http://www.w3.org/TR/xmlschema-2/#ID).

Методы интерфейса IOpcRelationship предоставляют доступ к свойствам связи для связи (которая представлена объектом связи). Методы, связанные свойства и описания перечислены в следующей таблице.

Метод	Свойство	Описание
GetId	Идентификатор связи	Уникальный произвольный идентификатор связи, которая является локальной по отношению к пакету.
GetRelationshipType	Тип отношений	Полное имя связи, определенное конструктором пакетов.
GetSourceUri	URI источника	Универсальный код ресурса (URI) источника связи. URI источника может быть URI пакета или части.
GetTargetMode	Целевой режим	Указывает, является ли целевой объект связи внутренним или внешним по отношению к пакету.
GetTargetUri	Целевой URI	Универсальный код ресурса (URI) целевого объекта связи.

Дополнительные сведения о связях см. в разделах Open Packaging Conventions Fundamentals и ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в начало работы с API упаковки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h