Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Type.GetTypeFromProgID (String, String, Boolean)

 

Publicado: octubre de 2016

Obtiene el tipo asociado al identificador de programa (ProgID) indicado desde el servidor especificado; debe indicarse si se producirá una excepción en caso de que se produzca un error al cargar el tipo.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

[SecurityCriticalAttribute]
public static Type GetTypeFromProgID(
	string progID,
	string server,
	bool throwOnError
)

Parámetros

progID
Type: System.String

Identificador de programa (ProgID) del Type que se va a obtener.

server
Type: System.String

Servidor desde el que se va a cargar el tipo. Si el nombre de servidor es null, el resultado que el método devuelve automáticamente es el equipo local.

throwOnError
Type: System.Boolean

true para producir cualquier excepción que se genere.

O bien

false para pasar por alto cualquier excepción que se produzca.

Valor devuelto

Type: System.Type

Tipo asociado al identificador de programa (ProgID) especificado si progID es una entrada de Registro válida y tiene un tipo asociado; en caso contrario, null.

Exception Condition
ArgumentException

El valor de progID es null.

COMException

El ProgID especificado no está registrado.

Este método se proporciona para la compatibilidad con COM. Los identificadores de programa no se utilizan en Microsoft .NET Framework porque se han sustituido por el concepto de espacio de nombres.

En el ejemplo siguiente se recupera un tipo pasando un ProgID y nombre de servidor. En el ejemplo, a continuación, muestra el identificador ClassID relacionado con el ProgID, que especifica si se va a producir una excepción si el ProgID o el nombre del servidor no es válido.


using System;
class MainApp 
{
    public static void Main()
    {
        try
        {
            // Use server localhost.
            string theServer="localhost";
            // Use  ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
            string myString1 ="DirControl.DirList.1"; 
            // Use a wrong ProgID WrongProgID.
            string myString2 ="WrongProgID"; 
            // Make a call to the method to get the type information for the given ProgID.
            Type myType1 =Type.GetTypeFromProgID(myString1,theServer,true);
            Console.WriteLine("GUID for ProgID DirControl.DirList.1 is {0}.", myType1.GUID);
            // Throw an exception because the ProgID is invalid and the throwOnError 
            // parameter is set to True.
            Type myType2 =Type.GetTypeFromProgID(myString2, theServer, true);
        }
        catch(Exception e)
        {
            Console.WriteLine("An exception occurred. The ProgID is wrong.");
            Console.WriteLine("Source: {0}" , e.Source);
            Console.WriteLine("Message: {0}" , e.Message);
        }
    }
}

SecurityCriticalAttribute

Requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: