This documentation is archived and is not being maintained.

User Assistance for Components

As a component author, you should provide assistance and documentation for your users about your components. You can provide assistance at design time through descriptive metadata, and at run time by calling HTML Help.

You can supply descriptive information about your component through the use of attributes. Attributes are specialized classes that are attached to other classes or class members and are emitted into metadata at compile time. Attributes can provide information to the user or directly to the development environment. For example, the DescriptionAttribute attribute, when attached to a property or event, displays a brief descriptive string in the Properties window. Other attributes affect the way the development environment behaves with the component. For example, the BrowsableAttribute attribute determines whether a property appears in the Properties window.

Run-time assistance is not usually supplied by a component, but there are some cases where it may make sense. For example, a very large and complex component may have built-in Help so the developers do not have to write extensive documentation. The .NET Framework Help object encapsulates the HTML Help 1.x engine, and can be used to supply Help to your users at run time with HTML or .chm files. For details, see Specifying a Help File for Your Component.

In This Section

Specifying a Help File for Your Component
Explains how to specify and display a Help file for your component at run time.
Providing Metadata Descriptions About Your Component
Demonstrates how to create and attach standard and custom descriptive attributes to your component.
Providing Metadata for Component Properties, Methods, and Events
Describes how to attach descriptive attributes to code members.

Related Sections

Help Support Changes in Visual Basic .NET
Describes changes in writing and providing Help in Visual Basic .NET.
Providing Help in a Windows Application
Describes how to provide Help in a Windows application.
Attributes Overview
Provides an overview of attributes and how they are used in the .NET Framework.