Map Class

XML Mapping Properties.When the object is serialized out as xml, its qualified name is x:Map.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Spreadsheet.Map

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(DataBinding))> _
Public Class Map _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Map
[ChildElementInfoAttribute(typeof(DataBinding))]
public class Map : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • DataBinding <x:DataBinding>

[ISO/IEC 29500-1 1st Edition]

18.16.2 Map (XML Mapping Properties)

This element contains all of the properties related to the XML map, and the behaviors expected during data refresh operations.

[Example:

<Map ID="1" Name="Root_Map" RootElement="Root" SchemaID="Schema1"
ShowImportExportValidationErrors="false" AutoFit="true" Append="false"
PreserveSortAFLayout="true" PreserveFormat="true">
<DataBinding ConnectionID="1" FileBinding="true" DataBindingLoadMode="1"/>
</Map>

end example]

Parent Elements

MapInfo (§18.16.3)

Child Elements

Subclause

DataBinding (XML Mapping)

§18.16.1

Attributes

Description

Append (Append Data to Table)

Specifies whether XML data should overwrite or be appended to the end of the table or range of mapped cells when data is refreshed.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

AutoFit (AutoFit Table on Refresh)

Specifies whether columns should be resized to fit the XML data after a data refresh operation.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

ID (XML Mapping ID)

Specifies the ID of the XML map.

The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype.

Name (XML Mapping Name)

Specifies the name of the XML map.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

PreserveFormat (Preserve Cell Formatting)

Specifies whether cell number formatting in the sheet should be preserved during data refresh operations, or whether the number formatting defined by the XML data type should be used.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

PreserveSortAFLayout (Preserve AutoFilter State)

Specifies whether to keep the filter state of the Table or cell range intact during a data refresh.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

RootElement (Root Element Name)

Specifies the names of the root XML element.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

SchemaID (Schema Name)

Specifies the unique name of the schema used for the mapping.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

ShowImportExportValidationErrors (Show Validation Errors)

Specifies whether XML schema validation errors should be displayed during data refresh or data export.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Map) 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.

See Also

Reference

Map Members

DocumentFormat.OpenXml.Spreadsheet Namespace