Type.GetTypeFromProgID Metodo

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Ottiene il tipo associato all'identificatore di programma specificato (ProgID).

Overload

Nome	Descrizione
GetTypeFromProgID(String)	Ottiene il tipo associato all'identificatore di programma specificato (ProgID), restituendo null se si verifica un errore durante il caricamento di Type.
GetTypeFromProgID(String, Boolean)	Ottiene il tipo associato all'identificatore di programma specificato (ProgID), specificando se generare un'eccezione se si verifica un errore durante il caricamento del tipo.
GetTypeFromProgID(String, String)	Ottiene il tipo associato all'identificatore di programma specificato (progID) dal server specificato, restituendo null se si verifica un errore durante il caricamento del tipo.
GetTypeFromProgID(String, String, Boolean)	Ottiene il tipo associato all'identificatore di programma specificato (progID) dal server specificato, specificando se generare un'eccezione se si verifica un errore durante il caricamento del tipo.

GetTypeFromProgID(String)

Origine:

Type.cs

Ottiene il tipo associato all'identificatore di programma specificato (ProgID), restituendo null se si verifica un errore durante il caricamento di Type.

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

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

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

Public Shared Function GetTypeFromProgID (progID As String) As Type

Parametri

progID

String

ProgID del tipo da ottenere.

Valori restituiti

Type

Tipo associato al ProgID specificato, se progID è una voce valida nel Registro di sistema e a cui è associato un tipo; in caso contrario, null.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

progID è null.

Commenti

Questo metodo viene fornito per il supporto COM. I progID non vengono usati nel framework di Microsoft .NET perché sono stati sostituiti dal concetto di spazio dei nomi.

Vedi anche

• GetProgIdForType(Type)

GetTypeFromProgID(String, Boolean)

Origine:

Type.cs

Ottiene il tipo associato all'identificatore di programma specificato (ProgID), specificando se generare un'eccezione se si verifica un errore durante il caricamento del tipo.

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

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

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

Public Shared Function GetTypeFromProgID (progID As String, throwOnError As Boolean) As Type

Parametri

progID

String

ProgID del tipo da ottenere.

throwOnError

Boolean

true per generare qualsiasi eccezione che si verifica.

oppure

false per ignorare qualsiasi eccezione che si verifica.

Valori restituiti

Type

Tipo associato all'identificatore di programma specificato (ProgID), se progID è una voce valida nel Registro di sistema e a un tipo è associato; in caso contrario, null.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

progID è null.

COMException

Il ProgID specificato non è registrato.

Esempio

Nell'esempio seguente viene recuperato un tipo passando un ProgID, specificando se generare un'eccezione se progID non è valido. Nell'esempio viene quindi visualizzato il ClassID correlato al ProgID, insieme a qualsiasi messaggio di eccezione applicabile.

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

Commenti

Questo metodo viene fornito per il supporto COM. Gli ID programma non vengono usati in Microsoft .NET Framework perché sono stati sostituiti dal concetto di spazio dei nomi.

Vedi anche

• GetProgIdForType(Type)

GetTypeFromProgID(String, String)

Origine:

Type.cs

Ottiene il tipo associato all'identificatore di programma specificato (progID) dal server specificato, restituendo null se si verifica un errore durante il caricamento del tipo.

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

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

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

Public Shared Function GetTypeFromProgID (progID As String, server As String) As Type

Parametri

progID

String

ProgID del tipo da ottenere.

server

String

Server da cui caricare il tipo. Se il nome del server è null, questo metodo ripristina automaticamente il computer locale.

Valori restituiti

Type

Tipo associato all'identificatore di programma specificato (progID), se progID è una voce valida nel Registro di sistema e a cui è associato un tipo; in caso contrario, null.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

progID è null.

Esempio

Nell'esempio seguente viene recuperato un tipo passando un ProgID e il nome del server. Nell'esempio viene quindi visualizzato il ClassID correlato a ProgID oppure viene generata un'eccezione se ProgID o il nome del server non è valido.

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

Commenti

Questo metodo viene fornito per il supporto COM. Gli ID programma non vengono usati in Microsoft .NET Framework perché sono stati sostituiti dal concetto di spazio dei nomi.

Vedi anche

• GetProgIdForType(Type)

GetTypeFromProgID(String, String, Boolean)

Origine:

Type.cs

Ottiene il tipo associato all'identificatore di programma specificato (progID) dal server specificato, specificando se generare un'eccezione se si verifica un errore durante il caricamento del 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);

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

Public Shared Function GetTypeFromProgID (progID As String, server As String, throwOnError As Boolean) As Type

Parametri

progID

String

ProgID dell'oggetto Type da ottenere.

server

String

Server da cui caricare il tipo. Se il nome del server è null, questo metodo ripristina automaticamente il computer locale.

throwOnError

Boolean

true per generare qualsiasi eccezione che si verifica.

oppure

false per ignorare qualsiasi eccezione che si verifica.

Valori restituiti

Type

Tipo associato all'identificatore di programma specificato (progID), se progID è una voce valida nel Registro di sistema e a cui è associato un tipo; in caso contrario, null.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

progID è null.

COMException

Il progID specificato non è registrato.

Esempio

Nell'esempio seguente viene recuperato un tipo passando un ProgID e il nome del server. Nell'esempio viene quindi visualizzato il ClassID correlato a ProgID, specificando se generare un'eccezione se ProgID o il nome del server non è valido.

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

Commenti

Questo metodo viene fornito per il supporto COM. Gli ID programma non vengono usati in Microsoft .NET Framework perché sono stati sostituiti dal concetto di spazio dei nomi.

Vedi anche

• GetProgIdForType(Type)
• TypeLoadException