|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
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.
- 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.