Sys.Component Class

Provides the base class for the Control and Behavior classes, and for any other object whose lifetime should be managed by the ASP.NET AJAX client library.

Namespace: Sys

Inherits: None

var a = new aComponent();

Constructors

Name	Description
Sys.Component Constructor	When overridden in a derived class, initializes an instance of that class and registers it with the application as a disposable object.

Members

Name	Description
Sys.Component.disposing Event	Raised when the dispose method of the current Component object is called.
Sys.Component.propertyChanged Event	Raised when the raisePropertyChanged method of the current Component object is called.
Sys.Component beginUpdate Method	Called by the create method to indicate that the process of setting properties of a component instance has begun.
Sys.Component.create Method	Creates and initializes a component.
Sys.Component.dispose Method	Removes the component from the application.
Sys.Component endUpdate Method	Called by the create method to indicate that the process of setting properties of a component instance has finished.
Sys.Component initialize Method	Initializes the component.
Sys.Component.raisePropertyChanged Method	Raises the propertyChanged event of the current Component object for a specified property.
Sys.Component updated Method	Called by the endUpdate method of the current Component object.
Sys.Component.events Property	Gets an EventHandlerList object that contains references to all the event handlers that are mapped to the current component's events.
Sys.Component id Property	Gets or sets the ID of the current Component object.
Sys.Component isInitialized Property	Gets a value indicating whether the current Component object is initialized.
Sys.Component isUpdating Property	Gets a value indicating whether the current Component is updating.

Remarks

The Component class provides the base class for all ASP.NET AJAX client controls, behaviors, and non-visual components on the page. It also provides the static create method, available as Sys.Component.Create or as the $create shortcut method, as a means to add an instance of a component, control, or behavior to your application. The create method is preferred over Sys.Application.addComponent because it sets all the properties that are required to define a component instance on page.

The Component class implements the INotifyDisposing interface. Any object in your application can subscribe to the disposing event of a component and use the event as a signal to dispose itself or to do other work. The Component class also implements the INotifyPropertyChanged interface, and therefore raises propertyChanged events. These events can be handled internally, subscribed to by other components, or both.

For information about how to create custom components that derive from Component, see the following topics.

Topic	Description
Creating Custom Non-Visual Client Components	Provides a conceptual overview of how to create ASP.NET AJAX client components, and includes detailed instructions and examples.
Creating a Client Component Class Using the Prototype Model	Shows the recommended format and syntax for creating ASP.NET AJAX client components using the prototype model.
Defining Custom Component Properties and Raising PropertyChanged Events	Shows how to define custom properties and raise property-change events in ASP.NET AJAX client components.
Releasing Component Resources	Shows how to use the dispose method to release resources in ASP.NET AJAX client components.
Creating Custom AJAX Client Controls	Shows how to create ASP.NET AJAX client controls, and includes detailed instructions and examples.
Creating an Extender Control to Associate a Client Behavior with a Web Server Control	Shows how to add ASP.NET AJAX client behaviors to server controls, and includes detailed instructions and examples.

See Also

Tasks

Creating Custom Non-Visual Client Components

Reference

new Operator

Concepts

Creating a Client Component Class Using the Prototype Model

Defining Custom Component Properties and Raising PropertyChanged Events

Releasing Component Resources

Other Resources

Language Reference