Share via


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