DdeLink Class
DDE Connection.When the object is serialized out as xml, its qualified name is x:ddeLink.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Spreadsheet.DdeLink
Namespace: DocumentFormat.OpenXml.Spreadsheet
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(DdeItems))> _
Public Class DdeLink _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As DdeLink
[ChildElementInfoAttribute(typeof(DdeItems))]
public class DdeLink : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
- DdeItems <x:ddeItems>
[ISO/IEC 29500-1 1st Edition]
18.14.4 ddeLink (DDE Connection)
This element represents a connection to an external Dynamic Data Exchange (DDE) server. DDE is a method of sending data between applications using Windows messages according to a documented protocol that has been stable since about 1990.
The hierarchy of names defined by a DDE server is Application, Topics, and Items. Topics often correspond to units such as files or documents or database names, and Items refer to subsets of the data such as cell ranges, rows, fields, columns. DDE items can have multiple values as well.
[Example:
Data connectivity can use a number of different technologies.The following is just one example of a spreadsheetML fragment describing the product Microsoft Excel being used as a DDE server to provide data to the current spreadsheet document:
<ddeLink xmlns:r="…" ddeService="excel" ddeTopic="[ddesource.xls]Sheet1"> <ddeItems> <ddeItem name="R1C1" advise="1"/> <ddeItem name="StdDocumentName" ole="1" advise="1"/> </ddeItems> </ddeLink>
end example]
Parent Elements |
|---|
externalLink (§18.14.8) |
Child Elements |
Subclause |
|---|---|
ddeItems (DDE Items Collection) |
§18.14.3 |
Attributes |
Description |
|---|---|
ddeService (Service name) |
Service name (i.e., application name) for the DDE connection. This is a required attribute. The possible values for this attribute are defined by the ST_Xstring simple type (§22.9.2.19). |
ddeTopic (Topic for DDE server) |
Describes something for the DDE application to which the channel pertains— usually a document of that application. This is a required attribute. 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_DdeLink) is located in §A.2. end note]
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.