Type.GetTypeFromProgID Método

Definição

Obtém o tipo associado com o ProgID (identificador programático) especificado.Gets the type associated with the specified program identifier (ProgID).

Sobrecargas

GetTypeFromProgID(String)

Obtém o tipo associado ao identificador de programa (ProgID) especificado, retornando null se for encontrado um erro ao carregar o Type.Gets the type associated with the specified program identifier (ProgID), returning null if an error is encountered while loading the Type.

GetTypeFromProgID(String, Boolean)

Obtém o tipo associado ao ProgID (identificador de programa) especificado, especificando se uma exceção deverá ser gerada se ocorrer um erro ao carregar o tipo.Gets the type associated with the specified program identifier (ProgID), specifying whether to throw an exception if an error occurs while loading the type.

GetTypeFromProgID(String, String)

Obtém o tipo associado ao progID (identificador de programa) especificado do servidor especificado, retornando nulo caso seja encontrado algum erro ao carregar o tipo.Gets the type associated with the specified program identifier (progID) from the specified server, returning null if an error is encountered while loading the type.

GetTypeFromProgID(String, String, Boolean)

Obtém o tipo associado ao progID (identificador de programa) especificado do servidor especificado, especificando se uma exceção deverá ser gerada se ocorrer um erro durante o carregamento do tipo.Gets the type associated with the specified program identifier (progID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.

GetTypeFromProgID(String)

Obtém o tipo associado ao identificador de programa (ProgID) especificado, retornando null se for encontrado um erro ao carregar o Type.Gets the type associated with the specified program identifier (ProgID), returning null if an error is encountered while loading the Type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID);
static member GetTypeFromProgID : string -> Type
Public Shared Function GetTypeFromProgID (progID As String) As Type

Parâmetros

progID
String

O ProgID do tipo a ser obtido.The ProgID of the type to get.

Retornos

O tipo associado ao ProgID especificado, se progID for uma entrada válida no Registro e um tipo for associado a ele; caso contrário, null.The type associated with the specified ProgID, if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Atributos

Exceções

progID é null.progID is null.

Comentários

Este método é fornecido para suporte COM.This method is provided for COM support. ProgIDs não são usados na estrutura Microsoft .NET porque foram substituídos pelo conceito de namespace.ProgIDs are not used in the Microsoft .NET Framework because they have been superseded by the concept of namespace.

Segurança

SecurityCriticalAttribute
Requer confiança total para o chamador imediato.Requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

GetTypeFromProgID(String, Boolean)

Obtém o tipo associado ao ProgID (identificador de programa) especificado, especificando se uma exceção deverá ser gerada se ocorrer um erro ao carregar o tipo.Gets the type associated with the specified program identifier (ProgID), specifying whether to throw an exception if an error occurs while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, bool throwOnError);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, bool throwOnError);
static member GetTypeFromProgID : string * bool -> Type
Public Shared Function GetTypeFromProgID (progID As String, throwOnError As Boolean) As Type

Parâmetros

progID
String

O ProgID do tipo a ser obtido.The ProgID of the type to get.

throwOnError
Boolean

true para gerar qualquer exceção que ocorra.true to throw any exception that occurs.

- ou --or- false para ignorar qualquer exceção que ocorra.false to ignore any exception that occurs.

Retornos

O tipo associado ao ProgID (identificador de programa) especificado, se progID for uma entrada válida no Registro e um tipo estiver associado a ele; caso contrário, null.The type associated with the specified program identifier (ProgID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Atributos

Exceções

progID é null.progID is null.

O ProgID especificado não está registrado.The specified ProgID is not registered.

Exemplos

O exemplo a seguir recupera um tipo passando um ProgID, especificando se uma exceção será lançada se o ProgID for inválido.The following example retrieves a type by passing a ProgID, specifying whether to throw an exception if the ProgID is invalid. Em seguida, o exemplo exibe o ClassID relacionado ao ProgID, juntamente com qualquer mensagem de exceção aplicável.The example then displays the ClassID related to the ProgID, along with any applicable exception message.

using namespace System;
int main()
{
   try
   {
      
      // Use the ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
      String^ myString1 = "DIRECT.ddPalette.3";
      
      // Use a nonexistent ProgID WrongProgID.
      String^ myString2 = "WrongProgID";
      
      // Make a call to the method to get the type information of the given ProgID.
      Type^ myType1 = Type::GetTypeFromProgID( myString1, 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, true );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }

}

using System;
class MainApp 
{
    public static void Main()
    {
        try
        {
            // Use the ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
            string myString1 ="DIRECT.ddPalette.3"; 
            // Use a nonexistent ProgID WrongProgID.
            string myString2 ="WrongProgID"; 
            // Make a call to the method to get the type information of the given ProgID.
            Type myType1 =Type.GetTypeFromProgID(myString1,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,true);
        }
        catch(Exception e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source: {0}", e.Source);
            Console.WriteLine("Message: {0}", e.Message);
        }
    }
}
Class MainApp
    Public Shared Sub Main()
        Try
            ' Use the ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
            Dim myString1 As String = "DIRECT.ddPalette.3"
            ' Use a nonexistent ProgID WrongProgID.
            Dim myString2 As String = "WrongProgID"
            ' Make a call to the method to get the type information of the given ProgID.
            Dim myType1 As Type = Type.GetTypeFromProgID(myString1, True)
            Console.WriteLine("GUID for ProgID DirControl.DirList.1 is {0}.", myType1.GUID.ToString())
            ' Throw an exception because the ProgID is invalid and the throwOnError 
            ' parameter is set to True.
            Dim myType2 As Type = Type.GetTypeFromProgID(myString2, True)
        Catch e As Exception
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Source: {0}", e.Source.ToString())
            Console.WriteLine("Message: {0}", e.Message.ToString())
        End Try
    End Sub
End Class

Comentários

Este método é fornecido para suporte COM.This method is provided for COM support. As IDs do programa não são usadas no Microsoft .NET Framework porque foram substituídas pelo conceito de namespace.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Segurança

SecurityCriticalAttribute
Requer confiança total para o chamador imediato.Requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

GetTypeFromProgID(String, String)

Obtém o tipo associado ao progID (identificador de programa) especificado do servidor especificado, retornando nulo caso seja encontrado algum erro ao carregar o tipo.Gets the type associated with the specified program identifier (progID) from the specified server, returning null if an error is encountered while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server);
static member GetTypeFromProgID : string * string -> Type
Public Shared Function GetTypeFromProgID (progID As String, server As String) As Type

Parâmetros

progID
String

O progID do tipo a ser obtido.The progID of the type to get.

server
String

O servidor do qual carregar o tipo.The server from which to load the type. Caso o nome do servidor seja null, este método retorna automaticamente para o computador local.If the server name is null, this method automatically reverts to the local machine.

Retornos

O tipo associado ao progID (identificador de programa) especificado, se o progID for uma entrada válida no Registro e houver um tipo associado a ele, caso contrário, null.The type associated with the specified program identifier (progID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Atributos

Exceções

prodID é null.prodID is null.

Exemplos

O exemplo a seguir recupera um tipo passando um ProgID e um nome de servidor.The following example retrieves a type by passing a ProgID and server name. Em seguida, o exemplo exibe o ClassID relacionado ao ProgID ou gera uma exceção se o ProgID ou o nome do servidor é inválido.The example then displays the ClassID related to the ProgID, or throws an exception if the ProgID or the server name is invalid.

using namespace System;
int main()
{
   try
   {
      
      // Use the ProgID localhost\HKEY_CLASSES_ROOT\DirControl::DirList.1.
      String^ theProgramID = "DirControl.DirList.1";
      
      // Use the server name localhost.
      String^ theServer = "localhost";
      
      // Make a call to the method to get the type information for the given ProgID.
      Type^ myType = Type::GetTypeFromProgID( theProgramID, theServer );
      if ( myType == nullptr )
      {
         throw gcnew Exception( "Invalid ProgID or Server." );
      }
      Console::WriteLine( "GUID for ProgID DirControl.DirList.1 is {0}.", myType->GUID );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }

}

using System;
class MainApp 
{
    public static void Main()
    {
        try
        {
            // Use the ProgID localhost\HKEY_CLASSES_ROOT\DirControl.DirList.1.
            string theProgramID ="DirControl.DirList.1"; 
            // Use the server name localhost.
            string theServer="localhost";
            // Make a call to the method to get the type information for the given ProgID.
            Type myType =Type.GetTypeFromProgID(theProgramID,theServer);
            if(myType==null)
            {
                throw new Exception("Invalid ProgID or Server.");
            }
            Console.WriteLine("GUID for ProgID DirControl.DirList.1 is {0}.", myType.GUID);
        }
        catch(Exception e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source: {0}" , e.Source);
            Console.WriteLine("Message: {0}" , e.Message);
        }		
    }
}
Class MainApp
    Public Shared Sub Main()
        Try
            ' Use ProgID localhost\HKEY_CLASSES_ROOT\DirControl.DirList.1.
            Dim theProgramID As String = "DirControl.DirList.1"
            ' Use Server name localhost.
            Dim theServer As String = "localhost"
            ' Make a call to the method to get the type information for the given ProgID.
            Dim myType As Type = Type.GetTypeFromProgID(theProgramID, theServer)
            If myType Is Nothing Then
                Throw New Exception("Invalid ProgID or server.")
            End If
            Console.WriteLine("GUID for ProgID DirControl.DirList.1 is {0}.", myType.GUID.ToString())
        Catch e As Exception
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Source: {0}.", e.Source.ToString())
            Console.WriteLine("Message: {0}.", e.Message.ToString())
        End Try
    End Sub
End Class

Comentários

Este método é fornecido para suporte COM.This method is provided for COM support. As IDs do programa não são usadas no Microsoft .NET Framework porque foram substituídas pelo conceito de namespace.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Segurança

SecurityCriticalAttribute
Requer confiança total para o chamador imediato.Requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

GetTypeFromProgID(String, String, Boolean)

Obtém o tipo associado ao progID (identificador de programa) especificado do servidor especificado, especificando se uma exceção deverá ser gerada se ocorrer um erro durante o carregamento do tipo.Gets the type associated with the specified program identifier (progID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server, bool throwOnError);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server, bool throwOnError);
static member GetTypeFromProgID : string * string * bool -> Type
Public Shared Function GetTypeFromProgID (progID As String, server As String, throwOnError As Boolean) As Type

Parâmetros

progID
String

A progID do Type a ser obtida.The progID of the Type to get.

server
String

O servidor do qual carregar o tipo.The server from which to load the type. Caso o nome do servidor seja null, este método retorna automaticamente para o computador local.If the server name is null, this method automatically reverts to the local machine.

throwOnError
Boolean

true para gerar qualquer exceção que ocorra.true to throw any exception that occurs.

- ou --or- false para ignorar qualquer exceção que ocorra.false to ignore any exception that occurs.

Retornos

O tipo associado ao progID (identificador de programa) especificado, se o progID for uma entrada válida no Registro e houver um tipo associado a ele, caso contrário, null.The type associated with the specified program identifier (progID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Atributos

Exceções

progID é null.progID is null.

A progID especificada não está registrada.The specified progID is not registered.

Exemplos

O exemplo a seguir recupera um tipo passando um ProgID e um nome de servidor.The following example retrieves a type by passing a ProgID and server name. Em seguida, o exemplo exibe o ClassID relacionado ao ProgID, especificando se uma exceção deve ser lançada se o ProgID ou o nome do servidor for inválido.The example then displays the ClassID related to the ProgID, specifying whether to throw an exception if the ProgID or the server name is invalid.

using namespace System;
int 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 );
   }

}


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);
        }
    }
}
Class MainApp
    Public Shared Sub Main()
        Try
            ' Use Server localhost.
            Dim theServer As String = "localhost"
            ' Use  ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
            Dim myString1 As String = "DirControl.DirList.1"
            ' Use a wrong ProgID WrongProgID.
            Dim myString2 As String = "WrongProgID"
            ' Make a call to the method to get the type information for the given ProgID.
            Dim myType1 As Type = Type.GetTypeFromProgID(myString1, theServer, True)
            Console.WriteLine("GUID for ProgID DirControl.DirList.1 is {0}.", myType1.GUID.ToString())
            ' Throw an exception because the ProgID is invalid and the throwOnError 
            ' parameter is set to True.
            Dim myType2 As Type = Type.GetTypeFromProgID(myString2, theServer, True)
        Catch e As Exception
            Console.WriteLine("An exception occurred. The ProgID is wrong.")
            Console.WriteLine("Source: {0}", e.Source.ToString())
            Console.WriteLine("Message: {0}", e.Message.ToString())
        End Try
    End Sub
End Class

Comentários

Este método é fornecido para suporte COM.This method is provided for COM support. As IDs do programa não são usadas no Microsoft .NET Framework porque foram substituídas pelo conceito de namespace.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Segurança

SecurityCriticalAttribute
Requer confiança total para o chamador imediato.Requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

Aplica-se a