mcs/class/System/Documentation/en/System.ComponentModel/Component.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <Type Name="Component" FullName="System.ComponentModel.Component">
   3   <TypeSignature Language="C#" Maintainer="auto" Value="public class Component : MarshalByRefObject, IDisposable, System.ComponentModel.IComponent" />
   4   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Component extends System.MarshalByRefObject implements class System.ComponentModel.IComponent, class System.IDisposable" />
   5   <AssemblyInfo>
   6     <AssemblyName>System</AssemblyName>
   7     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
   8     <AssemblyVersion>1.0.3300.0</AssemblyVersion>
   9     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  10     <AssemblyVersion>2.0.0.0</AssemblyVersion>
  11     <AssemblyVersion>4.0.0.0</AssemblyVersion>
  12   </AssemblyInfo>
  13   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
  14   <Base>
  15     <BaseTypeName>System.MarshalByRefObject</BaseTypeName>
  16   </Base>
  17   <Interfaces>
  18     <Interface>
  19       <InterfaceName>System.ComponentModel.IComponent</InterfaceName>
  20     </Interface>
  21     <Interface>
  22       <InterfaceName>System.IDisposable</InterfaceName>
  23     </Interface>
  24   </Interfaces>
  25   <Attributes>
  26     <Attribute>
  27       <AttributeName>System.ComponentModel.DesignerCategory("Component")</AttributeName>
  28     </Attribute>
  29     <Attribute>
  30       <AttributeName>System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)</AttributeName>
  31     </Attribute>
  32     <Attribute>
  33       <AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
  34     </Attribute>
  35   </Attributes>
  36   <Docs>
  37     <remarks>
  38       <attribution license="cc4" from="Microsoft" modified="false" />
  39       <para>
  40         <see cref="T:System.ComponentModel.Component" /> is the base class for all components in the common language runtime that marshal by reference. <see cref="T:System.ComponentModel.Component" /> is remotable and derives from the <see cref="T:System.MarshalByRefObject" /> class. <see cref="T:System.ComponentModel.Component" /> provides an implementation of the <see cref="T:System.ComponentModel.IComponent" /> interface. The <see cref="T:System.ComponentModel.MarshalByValueComponent" /> provides an implementation of <see cref="T:System.ComponentModel.IComponent" /> that marshals by value.</para>
  41       <para>You can host a <see cref="T:System.ComponentModel.Component" /> in any object that implements the <see cref="T:System.ComponentModel.IContainer" /> interface, and you can query and get services from its container. The container creates an <see cref="T:System.ComponentModel.ISite" /> for each <see cref="T:System.ComponentModel.Component" /> it contains. The container uses the site to manage the <see cref="T:System.ComponentModel.Component" /> and is used by the <see cref="T:System.ComponentModel.Component" /> to communicate with its container.</para>
  42       <para>A <see cref="T:System.ComponentModel.Component" /> should release resources explicitly by calls to its <see cref="M:System.ComponentModel.Component.Dispose" /> method, without waiting for automatic memory management through an implicit call to the <see cref="M:System.Object.Finalize" /> method. When a <see cref="T:System.ComponentModel.Container" /> is disposed, all components within the <see cref="T:System.ComponentModel.Container" /> are also disposed.</para>
  43     </remarks>
  44     <summary>
  45       <attribution license="cc4" from="Microsoft" modified="false" />
  46       <para>Provides the base implementation for the <see cref="T:System.ComponentModel.IComponent" /> interface and enables object sharing between applications.</para>
  47     </summary>
  48   </Docs>
  49   <Members>
  50     <Member MemberName=".ctor">
  51       <MemberSignature Language="C#" Value="public Component ();" />
  52       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
  53       <MemberType>Constructor</MemberType>
  54       <AssemblyInfo>
  55         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  56         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  57         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  58       </AssemblyInfo>
  59       <ReturnValue />
  60       <Parameters />
  61       <Docs>
  62         <remarks>To be added</remarks>
  63         <summary>
  64           <attribution license="cc4" from="Microsoft" modified="false" />
  65           <para>Initializes a new instance of the <see cref="T:System.ComponentModel.Component" /> class. </para>
  66         </summary>
  67       </Docs>
  68     </Member>
  69     <Member MemberName="CanRaiseEvents">
  70       <MemberSignature Language="C#" Value="protected virtual bool CanRaiseEvents { get; }" />
  71       <MemberSignature Language="ILAsm" Value=".property instance bool CanRaiseEvents" />
  72       <MemberType>Property</MemberType>
  73       <AssemblyInfo>
  74         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  75         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  76       </AssemblyInfo>
  77       <ReturnValue>
  78         <ReturnType>System.Boolean</ReturnType>
  79       </ReturnValue>
  80       <Docs>
  81         <value>To be added.</value>
  82         <remarks>
  83           <attribution license="cc4" from="Microsoft" modified="false" />
  84           <para>The default implementation of this property always returns true. Classes that inherit from the <see cref="T:System.ComponentModel.Component" /> class should override this property to provide the ability to disable the raising of events. For example, in the <see cref="T:System.Windows.Forms.Control" /> class, if the control is being hosted as an ActiveX control, the <see cref="P:System.Windows.Forms.Control.CanRaiseEvents" /> property returns false if the ActiveX control has its events frozen.</para>
  85         </remarks>
  86         <summary>
  87           <attribution license="cc4" from="Microsoft" modified="false" />
  88           <para>Gets a value indicating whether the component can raise an event.</para>
  89         </summary>
  90       </Docs>
  91     </Member>
  92     <Member MemberName="Container">
  93       <MemberSignature Language="C#" Value="public System.ComponentModel.IContainer Container { get; }" />
  94       <MemberSignature Language="ILAsm" Value=".property instance class System.ComponentModel.IContainer Container" />
  95       <MemberType>Property</MemberType>
  96       <AssemblyInfo>
  97         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  98         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  99         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 100       </AssemblyInfo>
 101       <Attributes>
 102         <Attribute>
 103           <AttributeName>System.ComponentModel.Browsable(false)</AttributeName>
 104         </Attribute>
 105         <Attribute>
 106           <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName>
 107         </Attribute>
 108       </Attributes>
 109       <ReturnValue>
 110         <ReturnType>System.ComponentModel.IContainer</ReturnType>
 111       </ReturnValue>
 112       <Docs>
 113         <value>To be added: an object of type 'IContainer'</value>
 114         <remarks>
 115           <attribution license="cc4" from="Microsoft" modified="false" />
 116           <para>The components in a container are tracked in a first-in, first-out list, which also defines the order of the components within the container. The last component added is the last component in the list.</para>
 117         </remarks>
 118         <summary>
 119           <attribution license="cc4" from="Microsoft" modified="false" />
 120           <para>Gets the <see cref="T:System.ComponentModel.IContainer" /> that contains the <see cref="T:System.ComponentModel.Component" />.</para>
 121         </summary>
 122       </Docs>
 123     </Member>
 124     <Member MemberName="DesignMode">
 125       <MemberSignature Language="C#" Value="protected bool DesignMode { get; }" />
 126       <MemberSignature Language="ILAsm" Value=".property instance bool DesignMode" />
 127       <MemberType>Property</MemberType>
 128       <AssemblyInfo>
 129         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 130         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 131         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 132       </AssemblyInfo>
 133       <Attributes>
 134         <Attribute>
 135           <AttributeName>System.ComponentModel.Browsable(false)</AttributeName>
 136         </Attribute>
 137         <Attribute>
 138           <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName>
 139         </Attribute>
 140       </Attributes>
 141       <ReturnValue>
 142         <ReturnType>System.Boolean</ReturnType>
 143       </ReturnValue>
 144       <Docs>
 145         <value>To be added: an object of type 'bool'</value>
 146         <remarks>
 147           <attribution license="cc4" from="Microsoft" modified="false" />
 148           <para>The design mode indicator is stored in the <see cref="T:System.ComponentModel.ISite" />; therefore, if the <see cref="T:System.ComponentModel.Component" /> does not have an <see cref="T:System.ComponentModel.ISite" /> associated with it, the value of this property is false.</para>
 149         </remarks>
 150         <summary>
 151           <attribution license="cc4" from="Microsoft" modified="false" />
 152           <para>Gets a value that indicates whether the <see cref="T:System.ComponentModel.Component" /> is currently in design mode.</para>
 153         </summary>
 154       </Docs>
 155     </Member>
 156     <Member MemberName="Dispose">
 157       <MemberSignature Language="C#" Value="public void Dispose ();" />
 158       <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose() cil managed" />
 159       <MemberType>Method</MemberType>
 160       <AssemblyInfo>
 161         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 162         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 163         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 164       </AssemblyInfo>
 165       <ReturnValue>
 166         <ReturnType>System.Void</ReturnType>
 167       </ReturnValue>
 168       <Parameters />
 169       <Docs>
 170         <remarks>
 171           <attribution license="cc4" from="Microsoft" modified="false" />
 172           <para>Call <see cref="M:System.ComponentModel.Component.Dispose" /> when you are finished using the <see cref="T:System.ComponentModel.Component" />. The <see cref="M:System.ComponentModel.Component.Dispose" /> method leaves the <see cref="T:System.ComponentModel.Component" /> in an unusable state. After calling <see cref="M:System.ComponentModel.Component.Dispose" />, you must release all references to the <see cref="T:System.ComponentModel.Component" /> so the garbage collector can reclaim the memory that the <see cref="T:System.ComponentModel.Component" /> was occupying. For more information, see <format type="text/html"><a href="a17b0066-71c2-4ba4-9822-8e19332fc213">Cleaning Up Unmanaged Resources</a></format> and <format type="text/html"><a href="eb4e1af0-3b48-4fbc-ad4e-fc2f64138bf9">Implementing a Dispose Method</a></format>. </para>
 173           <block subset="none" type="note">
 174             <para>Always call <see cref="M:System.ComponentModel.Component.Dispose" /> before you release your last reference to the <see cref="T:System.ComponentModel.Component" />. Otherwise, the resources it is using will not be freed until the garbage collector calls the <see cref="T:System.ComponentModel.Component" /> object's Finalize method.</para>
 175           </block>
 176         </remarks>
 177         <summary>
 178           <attribution license="cc4" from="Microsoft" modified="false" />
 179           <para>Releases all resources used by the <see cref="T:System.ComponentModel.Component" />.</para>
 180         </summary>
 181       </Docs>
 182     </Member>
 183     <Member MemberName="Dispose">
 184       <MemberSignature Language="C#" Value="protected virtual void Dispose (bool release_all);" />
 185       <MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance void Dispose(bool release_all) cil managed" />
 186       <MemberType>Method</MemberType>
 187       <AssemblyInfo>
 188         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 189         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 190         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 191       </AssemblyInfo>
 192       <ReturnValue>
 193         <ReturnType>System.Void</ReturnType>
 194       </ReturnValue>
 195       <Parameters>
 196         <Parameter Name="release_all" Type="System.Boolean" />
 197       </Parameters>
 198       <Docs>
 199         <param name="release_all">To be added: an object of type 'bool'</param>
 200         <remarks>
 201           <attribution license="cc4" from="Microsoft" modified="false" />
 202           <para>This method is called by the public <see cref="M:System.ComponentModel.Component.Dispose" /> method and the <see cref="M:System.Object.Finalize" /> method. Dispose() invokes the protected Dispose(Boolean) method with the <paramref name="disposing" /> parameter set to true. <see cref="M:System.Object.Finalize" /> invokes Dispose with <paramref name="disposing" /> set to false.</para>
 203           <para>When the <paramref name="disposing" /> parameter is true, this method releases all resources held by any managed objects that this <see cref="T:System.ComponentModel.Component" /> references. This method invokes the Dispose() method of each referenced object.</para>
 204         </remarks>
 205         <summary>
 206           <attribution license="cc4" from="Microsoft" modified="false" />
 207           <para>Releases the unmanaged resources used by the <see cref="T:System.ComponentModel.Component" /> and optionally releases the managed resources.</para>
 208         </summary>
 209       </Docs>
 210     </Member>
 211     <Member MemberName="Disposed">
 212       <MemberSignature Language="C#" Value="public event EventHandler Disposed;" />
 213       <MemberSignature Language="ILAsm" Value=".event class System.EventHandler Disposed" />
 214       <MemberType>Event</MemberType>
 215       <AssemblyInfo>
 216         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 217         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 218         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 219       </AssemblyInfo>
 220       <Attributes>
 221         <Attribute>
 222           <AttributeName>System.ComponentModel.Browsable(false)</AttributeName>
 223         </Attribute>
 224         <Attribute>
 225           <AttributeName>System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)</AttributeName>
 226         </Attribute>
 227       </Attributes>
 228       <ReturnValue>
 229         <ReturnType>System.EventHandler</ReturnType>
 230       </ReturnValue>
 231       <Parameters />
 232       <Docs>
 233         <remarks>
 234           <attribution license="cc4" from="Microsoft" modified="false" />
 235           <para>When you create a <see cref="E:System.ComponentModel.Component.Disposed" /> delegate, you identify the method that handles the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about the event handler delegates, see <format type="text/html"><a href="D98FD58B-FA4F-4598-8378-ADDF4355A115">Events and Delegates</a></format>.</para>
 236         </remarks>
 237         <summary>
 238           <attribution license="cc4" from="Microsoft" modified="false" />
 239           <para>Occurs when the component is disposed by a call to the <see cref="M:System.ComponentModel.Component.Dispose" /> method. </para>
 240         </summary>
 241       </Docs>
 242     </Member>
 243     <Member MemberName="Events">
 244       <MemberSignature Language="C#" Value="protected System.ComponentModel.EventHandlerList Events { get; }" />
 245       <MemberSignature Language="ILAsm" Value=".property instance class System.ComponentModel.EventHandlerList Events" />
 246       <MemberType>Property</MemberType>
 247       <AssemblyInfo>
 248         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 249         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 250         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 251       </AssemblyInfo>
 252       <ReturnValue>
 253         <ReturnType>System.ComponentModel.EventHandlerList</ReturnType>
 254       </ReturnValue>
 255       <Docs>
 256         <value>To be added: an object of type 'EventHandlerList'</value>
 257         <remarks>
 258           <attribution license="cc4" from="Microsoft" modified="false" />
 259           <para>For more information about handling events, see <format type="text/html"><a href="01E4F1BC-E55E-413F-98C7-6588493E5F67">Consuming Events</a></format>.</para>
 260         </remarks>
 261         <summary>
 262           <attribution license="cc4" from="Microsoft" modified="false" />
 263           <para>Gets the list of event handlers that are attached to this <see cref="T:System.ComponentModel.Component" />.</para>
 264         </summary>
 265       </Docs>
 266     </Member>
 267     <Member MemberName="Finalize">
 268       <MemberSignature Language="C#" Value="~Component ();" />
 269       <MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Finalize() cil managed" />
 270       <MemberType>Method</MemberType>
 271       <AssemblyInfo>
 272         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 273         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 274         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 275       </AssemblyInfo>
 276       <ReturnValue>
 277         <ReturnType>System.Void</ReturnType>
 278       </ReturnValue>
 279       <Parameters />
 280       <Docs>
 281         <remarks>
 282           <attribution license="cc4" from="Microsoft" modified="false" />
 283           <para>This method overrides <see cref="M:System.Object.Finalize" />. Application code should not call this method; an object's Finalize method is automatically invoked during garbage collection, unless finalization by the garbage collector has been disabled by a call to the <see cref="M:System.GC.SuppressFinalize(System.Object)" /> method. </para>
 284           <para>For more information, see <format type="text/html"><a href="fd376774-1643-499b-869e-9546a3aeea70">Finalize Methods and Destructors</a></format>, <format type="text/html"><a href="a17b0066-71c2-4ba4-9822-8e19332fc213">Cleaning Up Unmanaged Resources</a></format>, and <format type="text/html"><a href="8026cb68-fe93-43fc-96c1-c09ad7d64cd3">Overriding the Finalize Method</a></format>.</para>
 285         </remarks>
 286         <summary>
 287           <attribution license="cc4" from="Microsoft" modified="false" />
 288           <para>Releases unmanaged resources and performs other cleanup operations before the <see cref="T:System.ComponentModel.Component" /> is reclaimed by garbage collection.</para>
 289         </summary>
 290       </Docs>
 291     </Member>
 292     <Member MemberName="GetService">
 293       <MemberSignature Language="C#" Value="protected virtual object GetService (Type service);" />
 294       <MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance object GetService(class System.Type service) cil managed" />
 295       <MemberType>Method</MemberType>
 296       <AssemblyInfo>
 297         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 298         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 299         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 300       </AssemblyInfo>
 301       <ReturnValue>
 302         <ReturnType>System.Object</ReturnType>
 303       </ReturnValue>
 304       <Parameters>
 305         <Parameter Name="service" Type="System.Type" />
 306       </Parameters>
 307       <Docs>
 308         <remarks>
 309           <attribution license="cc4" from="Microsoft" modified="false" />
 310           <para>This method can be overridden by a derived class.</para>
 311         </remarks>
 312         <summary>
 313           <attribution license="cc4" from="Microsoft" modified="false" />
 314           <para>Returns an object that represents a service provided by the <see cref="T:System.ComponentModel.Component" /> or by its <see cref="T:System.ComponentModel.Container" />.</para>
 315         </summary>
 316         <returns>
 317           <attribution license="cc4" from="Microsoft" modified="false" />
 318           <para>An <see cref="T:System.Object" /> that represents a service provided by the <see cref="T:System.ComponentModel.Component" />, or null if the <see cref="T:System.ComponentModel.Component" /> does not provide the specified service.</para>
 319         </returns>
 320         <param name="service">
 321           <attribution license="cc4" from="Microsoft" modified="false" />A service provided by the <see cref="T:System.ComponentModel.Component" />. </param>
 322       </Docs>
 323     </Member>
 324     <Member MemberName="Site">
 325       <MemberSignature Language="C#" Value="public virtual System.ComponentModel.ISite Site { get; set; }" />
 326       <MemberSignature Language="ILAsm" Value=".property instance class System.ComponentModel.ISite Site" />
 327       <MemberType>Property</MemberType>
 328       <AssemblyInfo>
 329         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 330         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 331         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 332       </AssemblyInfo>
 333       <Attributes>
 334         <Attribute>
 335           <AttributeName>System.ComponentModel.Browsable(false)</AttributeName>
 336         </Attribute>
 337         <Attribute>
 338           <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName>
 339         </Attribute>
 340       </Attributes>
 341       <ReturnValue>
 342         <ReturnType>System.ComponentModel.ISite</ReturnType>
 343       </ReturnValue>
 344       <Parameters>
 345       </Parameters>
 346       <Docs>
 347         <value>To be added: an object of type 'ISite'</value>
 348         <remarks>
 349           <attribution license="cc4" from="Microsoft" modified="false" />
 350           <para>A <see cref="T:System.ComponentModel.Component" /> will have an <see cref="T:System.ComponentModel.ISite" /> if it has been added to an <see cref="T:System.ComponentModel.IContainer" /> and the <see cref="T:System.ComponentModel.IContainer" /> assigns an <see cref="T:System.ComponentModel.ISite" /> to it. The <see cref="T:System.ComponentModel.IContainer" /> is responsible for assigning the <see cref="T:System.ComponentModel.ISite" /> to the <see cref="T:System.ComponentModel.Component" />. Changing the value of the component's <see cref="T:System.ComponentModel.ISite" /> does not necessarily change the name of the site the <see cref="T:System.ComponentModel.Component" /> is assigned to. The <see cref="P:System.ComponentModel.Component.Site" /> property should be set only by an <see cref="T:System.ComponentModel.IContainer" />.</para>
 351           <para>The property value is null if the <see cref="T:System.ComponentModel.Component" /> is removed from its <see cref="T:System.ComponentModel.IContainer" />. Assigning null to this property does not necessarily remove the <see cref="T:System.ComponentModel.Component" /> from the <see cref="T:System.ComponentModel.IContainer" />.</para>
 352           <para>A <see cref="T:System.ComponentModel.Component" /> might or might not have a name. If a <see cref="T:System.ComponentModel.Component" /> is given a name, the name must be unique among other <see cref="T:System.ComponentModel.Component" /> objects within its <see cref="T:System.ComponentModel.IContainer" />. The <see cref="T:System.ComponentModel.ISite" /> stores the name of the <see cref="T:System.ComponentModel.Component" />; therefore, you can only name a <see cref="T:System.ComponentModel.Component" /> if it has an <see cref="T:System.ComponentModel.ISite" /> associated with it.</para>
 353         </remarks>
 354         <summary>
 355           <attribution license="cc4" from="Microsoft" modified="false" />
 356           <para>Gets or sets the <see cref="T:System.ComponentModel.ISite" /> of the <see cref="T:System.ComponentModel.Component" />.</para>
 357         </summary>
 358       </Docs>
 359     </Member>
 360     <Member MemberName="ToString">
 361       <MemberSignature Language="C#" Value="public override string ToString ();" />
 362       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ToString() cil managed" />
 363       <MemberType>Method</MemberType>
 364       <AssemblyInfo>
 365         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 366         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 367         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 368       </AssemblyInfo>
 369       <ReturnValue>
 370         <ReturnType>System.String</ReturnType>
 371       </ReturnValue>
 372       <Parameters />
 373       <Docs>
 374         <remarks>
 375           <attribution license="cc4" from="Microsoft" modified="false" />
 376           <para>A <see cref="T:System.ComponentModel.Component" /> may or may not have a name. If a <see cref="T:System.ComponentModel.Component" /> is given a name, the name is unique among other <see cref="T:System.ComponentModel.Component" /> objects within its <see cref="T:System.ComponentModel.IContainer" />.</para>
 377           <para>The <see cref="T:System.ComponentModel.ISite" /> stores the name of the <see cref="T:System.ComponentModel.Component" />. A <see cref="T:System.ComponentModel.Component" /> can only have an <see cref="T:System.ComponentModel.ISite" /> if it has been added to an <see cref="T:System.ComponentModel.IContainer" /> and the <see cref="T:System.ComponentModel.IContainer" /> assigns an <see cref="T:System.ComponentModel.ISite" /> to it.</para>
 378         </remarks>
 379         <summary>
 380           <attribution license="cc4" from="Microsoft" modified="false" />
 381           <para>Returns a <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any. This method should not be overridden.</para>
 382         </summary>
 383         <returns>
 384           <attribution license="cc4" from="Microsoft" modified="false" />
 385           <para>A <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any, or null if the <see cref="T:System.ComponentModel.Component" /> is unnamed.</para>
 386         </returns>
 387       </Docs>
 388     </Member>
 389   </Members>
 390 </Type>