FieldName Element for SubscriptionClass/Schema/Field (ADF)

Specifies the user-defined name of the subscription field.

Syntax

<SubscriptionClasses>
    <SubscriptionClass>
        ...
        <Schema>
            <Field>
                <FieldName>

Element Characteristics

Characteristic Description

Data type

string, between 1 and 128 characters in length.

Default value

None.

Occurrence

Required once per Field element.

Updates

Can be modified, but not added or deleted, when updating the application.

Element Relationships

Relationship Elements

Parent element

Field Element for SubscriptionClass/Schema (ADF)

Child elements

None.

Remarks

Field names must start with a letter or underscore character and can contain letters, numbers, and the characters _, #, @ and $. They must also conform to Microsoft SQL Server identifier conventions. For more information about SQL Server identifiers, see Identifiers.

Important

You cannot name a subscription field Created, Enabled, SubscriberId, SubscriptionId, or Updated. SQL Server 2005 Notification Services already uses these field names internally.

If you update a FieldName element, updating the application re-creates the subscription class to which it corresponds. A new subscription table is created, and the existing subscription table is renamed to SubscriptionTableNameOld. Existing subscription table indexes are left unchanged.

If you want to transfer data between the old and new subscription tables, it must be done manually. For more information, see Updating an Application.

Example

The following example shows a FieldName element.

<FieldName>SubscriberLocale</FieldName>

See Also

Reference

Application Definition File Reference

Other Resources

Defining the Subscription Schema
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance