SettingValueAttributes Attribute Group Attribute Group

Contains attributes used to control the behavior of setting values.

<xs:attributeGroup name="SettingValueAttributes">
    <xs:attribute name="Path"
        type="SettingPath"
        use="required"
     />
    <xs:attribute name="Null"
        type="boolean"
        use="optional"
     />
    <xs:attribute name="Fixed"
        type="boolean"
        use="optional"
     />
    <xs:attribute name="Unset"
        type="boolean"
        use="optional"
     />
    <xs:attribute name="Definition"
        type="QualifiedName"
        use="optional"
     />
    <xs:attribute name="Convert"
        type="boolean"
        use="optional"
     />
    <xs:attribute name="Secure"
        type="boolean"
        use="optional"
     />
    <xs:attribute name="Replace"
        type="boolean"
        use="optional"
     />
</xs:attributeGroup>

Attributes

Name	Type	Description
Convert	boolean	true if the runtime should try to convert the value to the target type when setting the value; otherwise, false.
Definition	QualifiedName	Reference to a setting definition. If this value is provided, then each of the setting values are typed with this definition; otherwise, the setting definition of the setting declaration at the end of the path is used as the type for each setting value.
Fixed	boolean	true if the setting value cannot be overwritten by new values. false if the setting can be overwritten.
Null	boolean	true if a setting value without content is considered valid. false if no setting values can be used without having content.
Path	SettingPath	The name of the setting declaration that this value will apply to.
Replace	boolean	true if the new value should replace the existing contents of the target setting's value; otherwise, false if the value will be merged with the target. This is only considered when the target value is a list, otherwise the target is always replaced.
Secure	boolean	true if this is a secure value; otherwise, false. This attribute will only be used if the setting declaration has been marked as Secure=PerInstance.
Unset	boolean	true if a conflicting setting value can be unset; otherwise false.

Remarks

If the value of Fixed is true on a setting value for a concrete definition member, it is fixed in all uses of that member and for all members of the concrete definition. Otherwise, if the value of Fixed is false, it is overrideable in each use of that member and it may vary with each member of the concrete definition.

If the value of Fixed is true on a setting value for an abstract definition, it is fixed for concrete definitions that implement or abstract objects that extend that abstract definition. Otherwise, if the value of Fixed is false, it may be overridden by a concrete definition in a derived abstract definition or in a member declaration.

See Also

SystemDefinitionModel Schema Attribute Groups

Send comments about this topic to Microsoft

Build date: 9/5/2007