Component Class (System.ComponentModel)

United States (English)

:ProfileText:

Home Library Learn Samples Downloads Support Community Forums

.NET Framework Class Library

Component Class

Provides the base implementation for the IComponent interface and enables object sharing between applications.

Inheritance Hierarchy

SystemObject
   SystemMarshalByRefObject
    System.ComponentModelComponent
      More...

Namespace: System.ComponentModel
Assembly: System (in System.dll)

Syntax

<[%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_0%](True)> _
<[%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_1%]([%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_2%].AutoDispatch)> _
Public Class Component _
	Inherits [%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_3%] _
	Implements [%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_4%], [%$TOPIC/9wbadbce_en-us_VS_110_3_0_0_0_5%]

[[%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_0%](true)]
[[%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_1%]([%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_2%].AutoDispatch)]
public class Component : [%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_3%], [%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_4%], 
	[%$TOPIC/9wbadbce_en-us_VS_110_3_0_1_0_5%]

[[%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_0%](true)]
[[%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_1%]([%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_2%]::AutoDispatch)]
public ref class Component : public [%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_3%], 
	[%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_4%], [%$TOPIC/9wbadbce_en-us_VS_110_3_0_2_0_5%]

[<[%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_0%](true)>]
[<[%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_1%]([%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_2%].AutoDispatch)>]
type Component =  
    class 
        inherit [%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_3%] 
        interface [%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_4%] 
        interface [%$TOPIC/9wbadbce_en-us_VS_110_3_0_3_0_5%] 
    end

The Component type exposes the following members.

Constructors

	Name	Description
	Component	Initializes a new instance of the Component class.

Top

Properties

	Name	Description
	CanRaiseEvents	Gets a value indicating whether the component can raise an event.
	Container	Gets the IContainer that contains the Component.
	DesignMode	Gets a value that indicates whether the Component is currently in design mode.
	Events	Gets the list of event handlers that are attached to this Component.
	Site	Gets or sets the ISite of the Component.

Top

Methods

	Name	Description
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	Dispose	Releases all resources used by the Component.
	Dispose(Boolean)	Releases the unmanaged resources used by the Component and optionally releases the managed resources.
	Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Overrides ObjectFinalize.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetService	Returns an object that represents a service provided by the Component or by its Container.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	ToString	Returns a String containing the name of the Component, if any. This method should not be overridden. (Overrides ObjectToString.) In XNA Framework 3.0, this member is inherited from Object ToString.

Top

Events

	Name	Description
	Disposed	Occurs when the component is disposed by a call to the Dispose method.

Top

Remarks

Component is the base class for all components in the common language runtime that marshal by reference. Component is remotable and derives from the MarshalByRefObject class. Component provides an implementation of the IComponent interface. The MarshalByValueComponent provides an implementation of IComponent that marshals by value.

You can host a Component in any object that implements the IContainer interface, and you can query and get services from its container. The container creates an ISite for each Component it contains. The container uses the site to manage the Component and is used by the Component to communicate with its container.

A Component should release resources explicitly by calls to its Dispose method, without waiting for automatic memory management through an implicit call to the Finalize method. When a Container is disposed, all components within the Container are also disposed.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.ComponentModel Namespace

Inheritance Hierarchy