Type.GetTypeFromCLSID Method (Guid, String, Boolean) (System)

Switch View :

ScriptFree

.NET Framework Class Library

Type.GetTypeFromCLSID Method (Guid, String, Boolean)

Gets the type associated with the specified class identifier (CLSID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.

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

Syntax

Visual Basic

Public Shared Function GetTypeFromCLSID ( _
	clsid As Guid, _
	server As String, _
	throwOnError As Boolean _
) As Type

public static Type GetTypeFromCLSID(
	Guid clsid,
	string server,
	bool throwOnError
)

Visual C++

public:
static Type^ GetTypeFromCLSID(
	Guid clsid, 
	String^ server, 
	bool throwOnError
)

static member GetTypeFromCLSID : 
        clsid:Guid * 
        server:string * 
        throwOnError:bool -> Type

Parameters

clsid: Type: System.Guid
The CLSID of the type to get.

server: Type: System.String
The server from which to load the type. If the server name is null, this method automatically reverts to the local machine.

throwOnError: Type: System.Boolean
true to throw any exception that occurs.
-or-
false to ignore any exception that occurs.

Return Value

Type: System.Type
System.__ComObject regardless of whether the CLSID is valid.

Remarks

Exceptions such as OutOfMemoryException will be thrown when specifying true for throwOnError, but it will not fail for unregistered CLSIDs.

Examples

The following example retrieves the type associated with the CLSID from the local host, specifying whether to throw an exception if an error occurs while loading the type.

Visual Basic


' Create a GUID.
Dim myGuid3 As New Guid("8D8529D3-625D-4496-8354-3DAD630ECC1B")
' Get the type associated with the CLSID
' from the local host and specify whether to throw an exception if an 
' error occurs while loading the type.
Dim myType3 As Type = Type.GetTypeFromCLSID(myGuid3, ".", True)
Console.WriteLine("The GUID associated with myType3 is {0}.", myType3.GUID.ToString())
Console.WriteLine("The type of the GUID is {0}.", myType3.ToString())


// Create a GUID.
Guid myGuid3 = new Guid("8D8529D3-625D-4496-8354-3DAD630ECC1B");
// Get the type associated with the CLSID
// from the local host and specify whether to throw an exception if an 
// error occurs while loading the type.
Type myType3 =Type.GetTypeFromCLSID(myGuid3, ".", true);
Console.WriteLine("The GUID associated with myType3 is {0}.", myType3.GUID);
Console.WriteLine("The type of the GUID is {0}.", myType3.ToString());

Visual C++


// Create a GUID.
Guid myGuid3 = Guid("8D8529D3-625D-4496-8354-3DAD630ECC1B");
// Get the type associated with the CLSID
// from the local host and specify whether to throw an exception if an
// error occurs while loading the type.
Type^ myType3 = Type::GetTypeFromCLSID( myGuid3, ".", true );
Console::WriteLine( "The GUID associated with myType3 is {0}.", myType3->GUID );
Console::WriteLine( "The type of the GUID is {0}.", myType3 );

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Reference

Type Class

GetTypeFromCLSID Overload

System Namespace