Compartir a través de


ForceUpgrade Class

Upgrade Document on Open.When the object is serialized out as xml, its qualified name is w:forceUpgrade.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.EmptyType
        DocumentFormat.OpenXml.Wordprocessing.ForceUpgrade

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

Syntax

'Declaration
Public Class ForceUpgrade _
    Inherits EmptyType
'Usage
Dim instance As ForceUpgrade
public class ForceUpgrade : EmptyType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.48 forceUpgrade (Upgrade Document on Open)

This element specifies that the contents of this document can be upgraded and that the resulting document shall not have its functionality limited to only those functions compatible with earlier word processing applications. The only actions required as part of upgrading the document are:

  • The removal of this element. If an application does not know how to upgrade a document, this element should be ignored and persisted.

  • The removal of all compatibility options (§17.15.1.21) on the document which maintain compatibility with previous word processing applications. The compatibility settings which simply affect a given behavior shall not be turned off.

[Note: The remaining operations which must be performed as part of upgrading the document are application-defined and outside the scope of ISO/IEC 29500. end note]

[Example: Consider a WordprocessingML document that specifies that it must automatically be upgraded when it is opened by an application. This requirement would be specified using the following WordprocessingML in the document settings part:

<w:forceUpgrade/> 

The forceUpgrade element's presence specifies that this document must be upgraded by any application which supports this operation. end example]

Parent Elements

settings (§17.15.1.78)

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

Reference

ForceUpgrade Members

DocumentFormat.OpenXml.Wordprocessing Namespace