DataSourceObject Class

Office Data Source Object Settings.When the object is serialized out as xml, its qualified name is w:odso.

Inheritance Hierarchy


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


<ChildElementInfoAttribute(GetType(MailMergeSource))> _
<ChildElementInfoAttribute(GetType(ColumnDelimiter))> _
<ChildElementInfoAttribute(GetType(SourceReference))> _
<ChildElementInfoAttribute(GetType(RecipientDataReference))> _
<ChildElementInfoAttribute(GetType(UdlConnectionString))> _
<ChildElementInfoAttribute(GetType(DataSourceTableName))> _
<ChildElementInfoAttribute(GetType(FirstRowHeader))> _
<ChildElementInfoAttribute(GetType(FieldMapData))> _
Public Class DataSourceObject _
    Inherits OpenXmlCompositeElement
Dim instance As DataSourceObject
public class DataSourceObject : OpenXmlCompositeElement


The following table lists the possible child types:

  • UdlConnectionString <w:udl>

  • DataSourceTableName <w:table>

  • SourceReference <w:src>

  • ColumnDelimiter <w:colDelim>

  • MailMergeSource <w:type>

  • FirstRowHeader <w:fHdr>

  • FieldMapData <w:fieldMapData>

  • RecipientDataReference <w:recipientData>

[ISO/IEC 29500-1 1st Edition]

17.14.25 odso (Office Data Source Object Settings)

This element specifies a group of additional settings for the mail merge information which comprise an extension to the standard settings stored with a mail merge which performs two functions:

  • First, it provides additional information about the mail merge data source, specifically: information about how to map the columns in the data source to MERGEFIELD fields and information about records which shall be included and excluded when creating merged documents, and column delimiters used in text data sources. This information can be used regardless of the value of the dataType element (§17.14.10) when it is present.

  • Second, it provides an alternate set of connection information which should be used when the dataType element (§17.14.10) specifies a value of native. This alternate connection string provides additional connection information for applications which choose to support the ODSO connection string syntax. If the dataType element (§17.14.10) specifies that the data type of the current mail merge is not native, then the second group of settings specified within this element shall be ignored in favor of their non-ODSO equivalents.

[Example: Consider the WordprocessingML for a source document whose mail merge includes mail merge information including ODSO settings as follows:

<w:udl w:val="…" />
<w:table w:val="Sheet1$" />
<w:src r:id="rId1" />
<w:colDelim w:val="9" />
<w:fHdr w:val="1" />
<w:type w:val="dbColumn" />
<w:name w:val="Title" />
<w:mappedName w:val="Courtesy Title" />
<w:lid w:val="en-US" />
<w:recipientData r:id="rId2" />

The odso element and its child elements provide all of the information specified above that is needed to carry out a mail merge with the current document. This includes alternate connection information using the udl, table, and src elements, and additional mail merge information in the other child elements. end example]

Parent Elements

mailMerge (§17.14.20)

Child Elements


colDelim (Column Delimiter for Data Source)


fHdr (First Row of Data Source Contains Column Names)


fieldMapData (External Data Source to Merge Field Mapping)


recipientData (Reference to Inclusion/Exclusion Data for Data Source)


src (ODSO Data Source File Path)


table (Data Source Table Name)


type (ODSO Data Source Type)


udl (UDL Connection String)


[Note: The W3C XML Schema definition of this element’s content model (CT_Odso) is located in §A.1. 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.

See Also


DataSourceObject Members

DocumentFormat.OpenXml.Wordprocessing Namespace