substitutionGroupExclusions Property
[This feature was only implemented for MSXML 6.0.]
Returns an enumerated value from the SCHEMADERIVATIONMETHOD declarations. The possible values are SCHEMADERIVATIONMETHOD_EXTENSION and SCHEMADERIVATIONMETHOD_RESTRICTION. The returned value is the derived-by type that will cause a substitution group affiliation to fail.
You create a substitution group affiliation by adding the substitutionGroup attribute to an <element> declaration. When the substitutionGroupExclusion attribute is set to "extension" and the affiliated element has been derived by extension, substitution will not work. When the substitutionGroupExclusion attribute is set to "restriction" and the affiliated element has been derived by restriction, substitution will not work. When both "extension" and "restriction" are set as values for the substitutionGroupExclusion attribute, no substitution is allowed for the elements in the affiliation group.
Example
The following example shows an XML Schema document that is not valid because 'eleB' cannot nominate 'eleA' as the head of its substitution group affiliation.
<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>
<xsd:element name='eleA' type='xsd:string' final='restriction'/>
<xsd:element name='eleB' substitutionGroup='eleA'>
<xsd:simpleType>
<xsd:restriction base='xsd:string'>
<xsd:maxLength value='20' />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name='eleSeq'>
<xsd:complexType>
<xsd:sequence>
<xsd:element ref='eleA' />
<xsd:element ref='eleB' />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
JScript Syntax
var enuSubstitutionGroupExclusions = oISchemaAttribute. substitutionGroupExclusions;
Parameters
None.
Return Values
enuSubstitutionGroupExclusions
An enumerated value. The substitution group exclusions. The following values are possible.
SCHEMADERIVATIONMETHOD_EXTENSION SCHEMADERIVATIONMETHOD_RESTRICTION
SCHEMADERIVATIONMETHOD_ALL
Visual Basic Syntax
enuSubstitutionGroupExclusions = oISchemaAttribute. substitutionGroupExclusions
Parameters
None.
Return Values
enuSubstitutionGroupExclusions
An enumerated value. The substitution group exclusions. The following values are possible.
SCHEMADERIVATIONMETHOD_EXTENSION SCHEMADERIVATIONMETHOD_RESTRICTION
SCHEMADERIVATIONMETHOD_ALL
C/C++ Syntax
HRESULT get_substitutionGroupExclusions(SCHEMADERIVATIONMETHOD* substitutionGroupExclusions);
Parameters
substitutionGroupExclusions[out,retval]
An enumerated value. The following values are possible. SCHEMADERIVATIONMETHOD_EXTENSION
SCHEMADERIVATIONMETHOD_RESTRICTION
SCHEMADERIVATIONMETHOD_ALL
Return Values
S_OK
The value returned if successful.
E_POINTER
The value returned if the substitutionsGroupExclusions parameter is NULL.
Versioning
Implemented in: MSXML 6.0