Share via

DTSXMLDiffOptions Enum

  • Reference

Definition

Namespace:
Microsoft.SqlServer.Dts.Tasks.XMLTask
Assembly:
Microsoft.SqlServer.XMLTask.dll

When the XMLTask has an OperationType set to Diff, then this enumeration is used to sets the options that affect the behavior of the comparison, as well as the resulting XDL DiffGram. The enumerations used will determine what items are included for consideration during the comparison.

This enumeration supports a bitwise combination of its member values.

public enum class DTSXMLDiffOptions
[System.Flags]
public enum DTSXMLDiffOptions
[<System.Flags>]
type DTSXMLDiffOptions = 
Public Enum DTSXMLDiffOptions
Inheritance
Enum
DTSXMLDiffOptions
Attributes
FlagsAttribute

Fields

Name Value Description
None 0

Specifies that that none of the options found in the enumeration are used.
IgnoreChildOrder 1

Specifies that the order of child nodes of each element is ignored. When this option is selected, two nodes with the same value that differ only by their position among sibling child nodes are treated as the same nodes.
IgnoreComments 2

Specifies that Comment nodes are not compared.
IgnorePI 4

Specifies that the namespace URIs of the element and attribute names are not compared. This option also implies that the name prefixes are ignored.
IgnoreWhitespace 8

Specifies that significant white spaces are not compared and that all text nodes are normalized by discarding any leading and trailing white space characters (#x9, #x10, #x13, #x20) and replacing sequences of white space characters with a single space (#x20) character.
IgnoreNamespaces 16

Specifies that the namespace Uniform Resource Identifiers (URIs) of the element and attribute names are not compared. This option also implies that the name prefixes are ignored.
IgnorePrefixes 32

Specifies that the prefixes of element and attribute names are not compared. When this option is selected, two names that have the same local name and namespace URI, but have a different prefix, are treated as the same names.
IgnoreXmlDecl 64

Specifies that the XML declaration is not compared.
IgnoreDtd 128

Specifies that document type declaration (DTD) is not compared.

Examples

The following code example assumes that an XMLTask has been created as myTask, with an OperationType set to Diff.

myTask.OperationType = DTSXMLOperation.Diff;  
myTask.DiffAlgorithm = DTSXMLDiffAlgorithm.Fast;  
myTask.DiffOptions = DTSXMLDiffOptions.IgnoreDtd;  
// To set multiple options, use OR.  
// myTask.DiffOptions = DTSXMLDiffOptions.IgnoreDtd or DTSXMLDiffOptions.IgnoreComments;  

myTask.OperationType = DTSXMLOperation.Diff  
myTask.DiffAlgorithm = DTSXMLDiffAlgorithm.Fast  
myTask.DiffOptions = DTSXMLDiffOptions.IgnoreDtd  
' To set multiple options, use OR.  
' myTask.DiffOptions = DTSXMLDiffOptions.IgnoreDtd or DTSXMLDiffOptions.IgnoreComments

Applies to