Type.GetTypeFromProgID Método

Definição

Espaço de Nomes:: System

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém o tipo associado ao identificador de programa especificado (ProgID).

Sobrecargas

Name	Description
GetTypeFromProgID(String)	Recebe o tipo associado ao identificador de programa especificado (ProgID), retornando nulo se for encontrado um erro durante o carregamento do Type.
GetTypeFromProgID(String, Boolean)	Obtém o tipo associado ao identificador do programa especificado (ProgID), especificando se deve lançar uma exceção caso ocorra um erro durante o carregamento do tipo.
GetTypeFromProgID(String, String)	Obtém o tipo associado ao identificador de programa especificado (progID) do servidor especificado, devolvendo nulo se for encontrado um erro durante o carregamento do tipo.
GetTypeFromProgID(String, String, Boolean)	Obtém o tipo associado ao identificador do programa especificado (progID) do servidor especificado, especificando se deve lançar uma exceção caso ocorra um erro durante o carregamento do tipo.

GetTypeFromProgID(String)

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Recebe o tipo associado ao identificador de programa especificado (ProgID), retornando nulo se for encontrado um erro durante o carregamento do Type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID(string progID);

public static Type? GetTypeFromProgID(string progID);

[System.Security.SecurityCritical]
public static Type GetTypeFromProgID(string progID);

public static Type GetTypeFromProgID(string progID);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetTypeFromProgID : string -> Type

static member GetTypeFromProgID : string -> Type

[<System.Security.SecurityCritical>]
static member GetTypeFromProgID : string -> Type

Public Shared Function GetTypeFromProgID (progID As String) As Type

Parâmetros

progID: String

O ProgID do tipo a obter.

Devoluções

Type

O tipo associado ao ProgID especificado, se progID for uma entrada válida no registo e um tipo estiver associado a ele; caso contrário, null.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentException

progID é null.

Observações

Este método é fornecido para suporte COM. Os ProgIDs não são usados no Microsoft .NET Framework porque foram substituídos pelo conceito de namespace.

Ver também

GetProgIdForType(Type)

Aplica-se a

GetTypeFromProgID(String, Boolean)

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Obtém o tipo associado ao identificador do programa especificado (ProgID), especificando se deve lançar uma exceção caso ocorra um erro durante o carregamento do tipo.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, bool throwOnError);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID(string progID, bool throwOnError);

public static Type? GetTypeFromProgID(string progID, bool throwOnError);

[System.Security.SecurityCritical]
public static Type GetTypeFromProgID(string progID, bool throwOnError);

public static Type GetTypeFromProgID(string progID, bool throwOnError);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetTypeFromProgID : string * bool -> Type

static member GetTypeFromProgID : string * bool -> Type

[<System.Security.SecurityCritical>]
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 obter.

throwOnError: Boolean

true para lançar qualquer exceção que ocorra.

-ou-

false ignorar qualquer exceção que ocorra.

Devoluções

Type

O tipo associado ao identificador do programa especificado (ProgID), se progID for uma entrada válida no registo e um tipo lhe estiver associado; caso contrário, null.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentException

progID é null.

COMException

O ProgID especificado não está registado.

Exemplos

O exemplo seguinte recupera um tipo ao passar um ProgID, especificando se deve lançar uma exceção caso o ProgID seja inválido. O exemplo apresenta então o ClassID relacionado com o ProgID, juntamente com qualquer mensagem de exceção aplicável.

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);
        }
    }
}

open System

try
    // Use the ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
    let myString1 ="DIRECT.ddPalette.3"
    // Use a nonexistent ProgID WrongProgID.
    let myString2 ="WrongProgID"
    // Make a call to the method to get the type information of the given ProgID.
    let myType1 =Type.GetTypeFromProgID(myString1, true)
    printfn $"GUID for ProgID DirControl.DirList.1 is {myType1.GUID}."
    // Throw an exception because the ProgID is invalid and the throwOnError
    // parameter is set to True.
    let myType2 =Type.GetTypeFromProgID(myString2, true)
    ()
with e ->
    printfn "An exception occurred."
    printfn $"Source: {e.Source}"
    printfn $"Message: {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

Observações

Este método é fornecido para suporte COM. Os IDs de Programa não são usados no Microsoft .NET Framework porque foram substituídos pelo conceito de namespace.

Ver também

GetProgIdForType(Type)

Aplica-se a

GetTypeFromProgID(String, String)

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Obtém o tipo associado ao identificador de programa especificado (progID) do servidor especificado, devolvendo nulo se for encontrado um erro durante o carregamento do tipo.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID(string progID, string? server);

public static Type? GetTypeFromProgID(string progID, string? server);

[System.Security.SecurityCritical]
public static Type GetTypeFromProgID(string progID, string server);

public static Type GetTypeFromProgID(string progID, string server);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetTypeFromProgID : string * string -> Type

static member GetTypeFromProgID : string * string -> Type

[<System.Security.SecurityCritical>]
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 obter.

server: String

O servidor de onde carregar o tipo. Se o nome do servidor for null, este método reverte automaticamente para a máquina local.

Devoluções

Type

O tipo associado ao identificador do programa especificado (progID), se progID for uma entrada válida no registo e um tipo lhe for associado; caso contrário, null.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentException

progID é null.

Exemplos

O exemplo seguinte recupera um tipo ao passar um ProgID e o nome do servidor. O exemplo mostra então o ClassID relacionado com o ProgID, ou lança uma exceção se o ProgID ou o nome do servidor forem inválidos.

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);
        }		
    }
}

open System

try
    // Use the ProgID localhost\HKEY_CLASSES_ROOT\DirControl.DirList.1.
    let theProgramID ="DirControl.DirList.1"
    // Use the server name localhost.
    let theServer="localhost"
    // Make a call to the method to get the type information for the given ProgID.
    let myType =Type.GetTypeFromProgID(theProgramID, theServer)
    if myType = null then
        raise (Exception "Invalid ProgID or Server.")
    printfn $"GUID for ProgID DirControl.DirList.1 is {myType.GUID}."
with e ->
    printfn "An exception occurred."
    printfn $"Source: {e.Source}"
    printfn $"Message: {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

Observações

Este método é fornecido para suporte COM. Os IDs de Programa não são usados no Microsoft .NET Framework porque foram substituídos pelo conceito de namespace.

Ver também

GetProgIdForType(Type)

Aplica-se a

GetTypeFromProgID(String, String, Boolean)

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Origem:: Type.cs

Obtém o tipo associado ao identificador do programa especificado (progID) do servidor especificado, especificando se deve lançar uma exceção caso ocorra um erro durante o carregamento do tipo.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server, bool throwOnError);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID(string progID, string? server, bool throwOnError);

public static Type? GetTypeFromProgID(string progID, string? server, bool throwOnError);

[System.Security.SecurityCritical]
public static Type GetTypeFromProgID(string progID, string server, bool throwOnError);

public static Type GetTypeFromProgID(string progID, string server, bool throwOnError);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetTypeFromProgID : string * string * bool -> Type

static member GetTypeFromProgID : string * string * bool -> Type

[<System.Security.SecurityCritical>]
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

O progID do Type a obter.

server: String

O servidor de onde carregar o tipo. Se o nome do servidor for null, este método reverte automaticamente para a máquina local.

throwOnError: Boolean

true para lançar qualquer exceção que ocorra.

-ou-

false ignorar qualquer exceção que ocorra.

Devoluções

Type

O tipo associado ao identificador do programa especificado (progID), se progID for uma entrada válida no registo e um tipo lhe for associado; caso contrário, null.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentException

progID é null.

COMException

O progID especificado não está registado.

Exemplos

O exemplo seguinte recupera um tipo ao passar um ProgID e o nome do servidor. O exemplo mostra então o ClassID relacionado com o ProgID, especificando se deve lançar uma exceção se o ProgID ou o nome do servidor for invá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);
        }
    }
}

open System
try
    // Use server localhost.
    let theServer="localhost"
    // Use  ProgID HKEY_CLASSES_ROOT\DirControl.DirList.1.
    let myString1 ="DirControl.DirList.1"
    // Use a wrong ProgID WrongProgID.
    let myString2 ="WrongProgID"
    // Make a call to the method to get the type information for the given ProgID.
    let myType1 =Type.GetTypeFromProgID(myString1, theServer, true)
    printfn $"GUID for ProgID DirControl.DirList.1 is {myType1.GUID}."
    // Throw an exception because the ProgID is invalid and the throwOnError
    // parameter is set to True.
    let myType2 =Type.GetTypeFromProgID(myString2, theServer, true)
    ()
with e ->
    printfn "An exception occurred. The ProgID is wrong."
    printfn $"Source: {e.Source}"
    printfn $"Message: {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

Observações

Este método é fornecido para suporte COM. Os IDs de Programa não são usados no Microsoft .NET Framework porque foram substituídos pelo conceito de namespace.

Ver também

Aplica-se a

Comentários

Esta página foi útil?