choice

MSXML 5.0 SDK

Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - XML Schemas

choice

Allows one and only one of the elements contained in the selected group to be present within the containing element.

<choice
  id = ID 
  maxOccurs= (nonNegativeInteger | unbounded) : 1
  minOccurs= nonNegativeInteger : 1 
  {any attributes with non-schema Namespace}…>
Content: (annotation?, (element | group | choice | sequence | any)*)
</choice>

Attributes

id
The ID of this element. The id value must be of type ID and be unique within the document containing this element.

Optional.

maxOccurs
The maximum number of times the choice can occur. The value can be an integer greater than or equal to zero. To set no limit on the maximum number, use the string "unbounded". Default value is 1.

Optional.

minOccurs
The minimum number of times the choice can occur. The value can be an integer greater than or equal to zero. To specify that this choice group is optional, set this attribute to zero. Default value is 1.

Optional.

Element Information

Number of occurrences One within group and complexType elements; otherwise, unlimited.
Parent elements group, choice, sequence, complexType, restriction (simpleContent), extension (simpleContent), restriction (complexContent), extension (complexContent)
Contents annotation, any, choice, element, group, sequence

Example

The following complex type defines an element with one attribute and one and only one element from a choice of four specified elements.

<xs:complexType name="chadState">
 <xs:choice minOccurs="1" maxOccurs="1">
  <xs:element ref="selected"/>
  <xs:element ref="unselected"/>
  <xs:element ref="dimpled"/>
  <xs:element ref="perforated"/>
 </xs:choice>
 <xs:attribute name="candidate" type="candidateType"/>
</xs:complexType>

See Also

XML Schema Reference (XSD) | XML Schema Elements

For more information, see the W3C XML Schema Part 1: Structures Recommendation at http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/#element-choice.