This documentation is archived and is not being maintained.

OleLink Class

OLE Link.When the object is serialized out as xml, its qualified name is x:oleLink.

Namespace:  DocumentFormat.OpenXml.Spreadsheet
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(OleItems))]
public class OleLink : OpenXmlCompositeElement

The following table lists the possible child types:

  • OleItems <x:oleItems>


[ISO/IEC 29500-1 1st Edition]

18.14.11 oleLink (Generic Object Link Connection)

This element represents an external link to an embedded object, specified by a progID/object pair. The type of object link is determined by reading the target of the id attribute.

[Example: The following markup defines a reference to a linked object using Bonobo. The progId attribute contains the shared library that contains the widget. The r:id identifies the referenced Bonobo object.

<oleLink r:id="rb1" progId="OAFIID:Bonobo_Sample_Calculator">
  … 
</oleLink>

The target of the relationship with ID rb1, defines the Bonobo object itself. This example shows a link to a sample Bonobo widget taken from the following article, which also provides an introduction to Bonobo – http://www.ibm.com/developerworks/webservices/library/co-bnbo2.html. end example]

[Example: The following markup defines a reference to a linked object using KParts. The progId attribute contains the shared library that contains the plugin. The r:id identifies the referenced KParts object.

<oleLink r:id="rKp1" progId="libhtmlvalidatorplugin">
  …
</oleLink>

The following XML, contained in the target of the relationship with ID rKp1, defines the KPart object, and will follow the kpartgui DTD:

<!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
<kpartgui library="libhtmlvalidatorplugin" name="htmlvalidatorplugin" version="1" >
  <MenuBar>
    <Menu name="tools"><Text>&amp;Tools</Text>
      <Action name="validatewebpage"/>
    </Menu>
  </MenuBar>
</kpartgui>

This example is taken from the kde.org web site, and contains a tutorial on building the plugin referenced by the above markup – http://developer.kde.org/documentation/tutorials/dot/writing-plugins.html. end example]

Parent Elements

externalLink (§18.14.8)

Child Elements

Subclause

oleItems (Object Link Items)

§18.14.10

Attributes

Description

id (Object Link Relationship)

Namespace: .../officeDocument/2006/relationships

Relationship ID that references a link in the relationships collection. The target attribute in the associated relationship will specify the external file name used for this oleLink.

The possible values for this attribute are defined by the ST_RelationshipId simple type (§22.8.2.1).

progId (Object Link Identifier)

The ID for the object link connection. [Example: For a KParts link, this would store the name of the appropriate KParts library. For an OLE link, this would store the ProgID of the appropriate OLE object. end example]

The possible values for this attribute are defined by the ST_Xstring simple type (§22.9.2.19).

[Note: The W3C XML Schema definition of this element’s content model (CT_OleLink) is located in §A.2. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: