NETHostCtrl.Create Method (ExNETHost)

The Create method loads the specified file ( AssemblyLocation ), and creates the giving type ( AssemblyName ). The assemblyLocation parameter of the Create method indicates the same value as AssemblyLocation property. The assemblyName parameter of the Create method indicates the same value as AssemblyName property. The Create method returns the type of the object being created, the same as IsCreated property returns the type of the object being created such as: NETHostType_exNETHostControl, if an object of System.Windows.Forms.Control type was created or NETHostType_exNETHostObject a generic object was created. The Host property returns the object being created and hosted by the NETHost control. The Destroy method unloads the hosting control.

There are three ways of loading/creating a manifest/component/assembly as listed:

AssemblyLocation property, loads the first public, browseable control found in the specified location. If there are more public, browseable controls in the assembly, you can use the AssemblyName or AssemblyQualifiedName property to specify the fully qualified name of the type to be hosted.
AssemblyQualifiedName property, loads and creates the object based on the assembly-qualified name of the type, which includes the name of the assembly from which this type object was loaded. Sample: "System.Windows.Forms.ListView, System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
Create(assemblyLocation, assemblyName) method loads the specified file, and creates the giving type.

If succeeded, ( the assembly is loaded and the object is created ), the

IsCreated property returns the type of the object being created such as: NETHostType_exNETHostControl, if an object of System.Windows.Forms.Control type was created or NETHostType_exNETHostObject a generic object was created.
AssemblyLocation property returns the location of the loaded file that contains the manifest/component/assembly. Sample: "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
AssemblyName property returns the fully qualified name of the type, including its namespace but not its assembly. Sample: "System.Windows.Forms.ScrollableControl"
AssemblyQualifiedName property gets the assembly-qualified name of the type, which includes the name of the assembly from which this type object was loaded. Sample: "System.Windows.Forms.ScrollableControl, System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"

If fails, the

IsCreated property returns NETHostType_exNETHostNothing, which indicates no object has been created
AssemblyLocation, AssemblyName and AssemblyQualifiedName return empty string
Host property returns nothing.

		Type	Description
		AssemblyLocation as String	A String expression that specifies the full path or UNC location of the loaded file that contains the manifest/component/assembly. Sample: "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
		AssemblyName as String	A String expression that specifies the fully qualified name of the type, including its namespace but not its assembly. Sample: "System.Windows.Forms.TreeView"

		Return	Description
		NETHostType	A NETHostType expression that specifies the type of the object being created, the same as value being returned by the IsCreated property. The return value can be one of the following: 0/ NETHostType_exNETHostNothing, The NETHost control hosts nothing. 1/ NETHostType_exNETHostControl, The NETHost component hosts an object of System.Windows.Forms.Control type. 2/ NETHostType_exNETHostObject, The NETHost component hosts a general object.