implab/ImplabNet Files · Implab/Components/IInitializable.cs

working on runnable components

cin - - Load All Authors

File last commit:

r251:7c7e9ad6fe4a v3


                r257:440801d88019

Download file

             IInitializable.cs
        
                    28 lines
            
             | 1.2 KiB
            
                | text/x-csharp
            
             |
                CSharpLexer
            
             / Implab / Components / IInitializable.cs
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      using System;

      namespace Implab.Components {

          /// <summary>

          /// Initializable components are created and initialized in two steps, first we have create the component,

          /// then we have to complete it's creation by calling an <see cref="Initialize()"/> method. All parameters needed

          /// to complete the initialization must be passed before the calling <see cref="Initialize()"/>

          /// </summary>

          public interface IInitializable {

              /// <summary>

              /// Completes initialization.

              /// </summary>

              /// <remarks>

              /// <para>

              /// Normally virtual methods shouldn't be called from the constructor, due to the incomplete object state, but

              /// they can be called from this method. This method is also usefull when we constructing a complex grpah

              /// of components where cyclic references may take place.

              /// </para>

              /// <para>

              /// In asyncronous patterns <see cref="Initialize()"/> can be called

              /// to start initialization and the <see cref="IRunnable.Completion"/>

              /// property can be used to track operation completion.

              /// </para>

              /// </remarks>

              void Initialize();

          }

      }

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				using System;

				namespace Implab.Components {
				/// <summary>
				/// Initializable components are created and initialized in two steps, first we have create the component,
				/// then we have to complete it's creation by calling an <see cref="Initialize()"/> method. All parameters needed
				/// to complete the initialization must be passed before the calling <see cref="Initialize()"/>
				/// </summary>
				public interface IInitializable {
				/// <summary>
				/// Completes initialization.
				/// </summary>
				/// <remarks>
				/// <para>
				/// Normally virtual methods shouldn't be called from the constructor, due to the incomplete object state, but
				/// they can be called from this method. This method is also usefull when we constructing a complex grpah
				/// of components where cyclic references may take place.
				/// </para>
				/// <para>
				/// In asyncronous patterns <see cref="Initialize()"/> can be called
				/// to start initialization and the <see cref="IRunnable.Completion"/>
				/// property can be used to track operation completion.
				/// </para>
				/// </remarks>
				void Initialize();
				}
				}