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