SettingValueList Complex Type Complex Type

Defines the list of attributes and elements used to define one or more setting values for a setting declared as a list. The SettingValueList complex type allows manipulation of multivalued settings. The list is a sequence of values with the same definition as the setting declaration.

<xs:complexType name="SettingValueList">
    <xs:sequence>
        <xs:element name="Value"
            minOccurs="0"
            maxOccurs="unbounded"
        >
            <xs:complexType
                mixed="true"
            >
                <xs:sequence>
                    <xs:any
                        processContents="skip"
                        minOccurs="0"
                        maxOccurs="unbounded"
                        namespace=""
                     />
                </xs:sequence>
                <xs:attribute name="Null"
                    type="boolean"
                    use="optional"
                 />
            </xs:complexType>
        </xs:element>
    </xs:sequence>
    <xs:attributeGroup
        ref="SettingValueAttributes"
     />
</xs:complexType>

Child Elements

Element	Type	Description
Value		A value in the list of setting values.

Attributes

Name	Type	Description
Null	boolean	true if the value can be null; otherwise, false.

Attribute Groups

Name	Description
SettingValueAttributes	Controls the behavior of setting values.

Remarks

When declaring setting values, you can decide to merge the declared values with the previous setting values or overwrite all the previous values.

A setting list declaration includes an attribute list set to true, as in the following example:

<SettingDeclaration Name="roles" Definition="String" List="true"/>

Values are then provided using a SettingValueList complex type. When providing the list, the user can specify whether to replace or append to the previous values.

<SettingValueList Path="roles" Fixed="true" Replace="true">
    <Value>staticContent</Value>
    <Value>aspPages</Value>
</SettingValueList>

See Also

SystemDefinitionModel Schema Complex Types

Send comments about this topic to Microsoft

Build date: 9/5/2007