Element: EnsureTable

Description

Use this element to ensure that a table appears in the installer database, even if its empty.

Derived By

Restricting anyType

Attributes

Name	Type	Required?	Default	Description
Id	string	Yes		The name of the table.

Content Model

Always empty.

Referenced By

• Element Fragment

Definition

<xs:element name="EnsureTable">
  <xs:annotation>
    <xs:documentation>
                Use this element to ensure that a table appears in the installer database, even if its empty.  
            </xs:documentation>
    <xs:appinfo>
      <xse:remarks xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension">
                    This element is particularly useful for two problems that may occur while merging merge modules:
                    <html:ol xmlns:html="http://www.w3.org/1999/xhtml"><html:li>
                            The first likely problem is that in order to properly merge you need to have certain
                            tables present prior to merging.  Using this element is one way to ensure those tables
                            are present prior to the merging.
                        </html:li><html:li>
                            The other common problem is that a merge module has incorrect validation information
                            about some tables.  By ensuring these tables prior to merging, you can avoid this
                            problem because the correct validation information will go into the installer database
                            before the merge module has a chance to set it incorrectly.
                        </html:li></html:ol></xse:remarks>
    </xs:appinfo>
  </xs:annotation>
  <xs:complexType>
    <xs:attribute name="Id" use="required" type="xs:string">
      <xs:annotation>
        <xs:documentation>The name of the table.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

---