Export (0) Print
Expand All

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)

public static Type GetTypeFromCLSID (
	Guid clsid,
	string server,
	bool throwOnError
)
public static Type GetTypeFromCLSID (
	Guid clsid, 
	String server, 
	boolean throwOnError
)
public static function GetTypeFromCLSID (
	clsid : Guid, 
	server : String, 
	throwOnError : boolean
) : Type
Not applicable.

Parameters

clsid

The CLSID of the type to get.

server

The server from which to load the type. If the server name is a null reference (Nothing in Visual Basic), this method automatically reverts to the local machine.

throwOnError

true to throw any exception that occurs.

-or-

false to ignore any exception that occurs.

Return Value

System.__ComObject regardless of whether the CLSID is valid.

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

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.

// 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()); 

// 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.get_GUID());
Console.WriteLine("The type of the GUID is {0}.",
    myType3.ToString());

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft