DoNotSuppressBlankLines Class
Remove Blank Lines from Merged Documents.When the object is serialized out as xml, its qualified name is w:doNotSuppressBlankLines.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlLeafElement
DocumentFormat.OpenXml.Wordprocessing.OnOffType
DocumentFormat.OpenXml.Wordprocessing.DoNotSuppressBlankLines
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
Public Class DoNotSuppressBlankLines _
Inherits OnOffType
'Usage
Dim instance As DoNotSuppressBlankLines
public class DoNotSuppressBlankLines : OnOffType
Remarks
[ISO/IEC 29500-1 1st Edition]
17.14.12 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.
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.