Export (0) Print
Expand All

DoNotSuppressBlankLines class

Remove Blank Lines from Merged Documents. When the object is serialized out as xml, its qualified name is w:doNotSuppressBlankLines.

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

public class DoNotSuppressBlankLines : OnOffType

[ISO/IEC 29500-1 1st Edition]

doNotSuppressBlankLines (Remove Blank Lines from Merged Documents)

This element specifies how an application performing the mail merge shall handle blank lines in the merged documents resulting from the mail merge. Typically, when a mail merge is performed, any blank lines which result from lines whose sole contents are merge fields with no content are removed from the merged document in order to prevent extraneous blank lines from appearing in the merged documents. When this element is present, the merged documents which are generated from the mail merge shall not have any blank lines removed before they are sent to their destination format.

If this element is omitted, the merged documents generated from this mail merge shall have all blank lines suppressed if they consist of only merge fields with values consisting of empty strings.

[Example: Consider a WordprocessingML document containing a single WordprocessingML field calling for Test data as seen in the first column of the table below. If the current record in the mail merge data source contains an empty string for the Test column, the resulting merged document would be displayed as follows depending on the setting for the doNotSuppressBlankLines element:

Source Document

<w:doNotSuppressBlankLines val="true" />
<w:doNotSuppressBlankLines val="false" />

One

Two

{MERGEFIELD "Test" }

Three

One

Two

Three

One

Two

Three

With this element set to a value of true, the blank lines in the resulting document must not be suppressed when the resulting merged documents are created. end example]

Parent Elements

mailMerge (§17.14.20)

This element’s content model is defined by the common boolean property definition in §17.17.4.

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

Show:
© 2014 Microsoft