Type.GetTypeFromProgID Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist.

Überlädt

GetTypeFromProgID(String)	Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist, und gibt NULL zurück, wenn beim Laden der Typeein Fehler auftritt.
GetTypeFromProgID(String, Boolean)	Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist, der angibt, ob eine Ausnahme ausgelöst werden soll, wenn beim Laden des Typs ein Fehler auftritt.
GetTypeFromProgID(String, String)	Ruft den Typ ab, der dem angegebenen Programmbezeichner (progID) vom angegebenen Server zugeordnet ist, und gibt NULL zurück, wenn beim Laden des Typs ein Fehler auftritt.
GetTypeFromProgID(String, String, Boolean)	Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) vom angegebenen Server zugeordnet ist, der angibt, ob eine Ausnahme ausgelöst werden soll, wenn beim Laden des Typs ein Fehler auftritt.

GetTypeFromProgID(String)

Quelle:

Type.cs

Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist, und gibt NULL zurück, wenn beim Laden der Typeein Fehler auftritt.

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

Parameter

progID

String

Die ProgID des abzurufenden Typs.

Gibt zurück

Type

Der typ, der der angegebenen ProgID zugeordnet ist, wenn progID ein gültiger Eintrag in der Registrierung ist und einem Typ zugeordnet ist; andernfalls null.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

progID ist null.

Hinweise

Diese Methode wird für die COM-Unterstützung bereitgestellt. ProgIDs werden im Microsoft .NET Framework nicht verwendet, da sie durch das Konzept des Namespace ersetzt wurden.

Weitere Informationen

• GetProgIdForType(Type)

GetTypeFromProgID(String, Boolean)

Quelle:

Type.cs

Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist, der angibt, ob eine Ausnahme ausgelöst werden soll, wenn beim Laden des Typs ein Fehler auftritt.

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

Parameter

progID

String

Die ProgID des abzurufenden Typs.

throwOnError

Boolean

true, um eine Ausnahme auszuwerfen, die auftritt.

-oder-

false alle ausnahmefehler zu ignorieren.

Gibt zurück

Type

Der Typ, der dem angegebenen Programmbezeichner (ProgID) zugeordnet ist, wenn progID ein gültiger Eintrag in der Registrierung ist und einem Typ zugeordnet ist; andernfalls null.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

progID ist null.

COMException

Die angegebene ProgID ist nicht registriert.

Beispiele

Im folgenden Beispiel wird ein Typ abgerufen, indem eine ProgID übergeben wird, die angibt, ob eine Ausnahme ausgelöst werden soll, wenn die ProgID ungültig ist. Im Beispiel wird dann die ClassID im Zusammenhang mit der ProgID zusammen mit jeder zutreffenden Ausnahmemeldung angezeigt.

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

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

Hinweise

Diese Methode wird für die COM-Unterstützung bereitgestellt. Programm-IDs werden in Microsoft .NET Framework nicht verwendet, da sie durch das Konzept des Namespace ersetzt wurden.

Weitere Informationen

• GetProgIdForType(Type)

GetTypeFromProgID(String, String)

Quelle:

Type.cs

Ruft den Typ ab, der dem angegebenen Programmbezeichner (progID) vom angegebenen Server zugeordnet ist, und gibt NULL zurück, wenn beim Laden des Typs ein Fehler auftritt.

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

Parameter

progID

String

Die progID des abzurufenden Typs.

server

String

Der Server, von dem der Typ geladen werden soll. Wenn der Servername nullist, wird diese Methode automatisch auf den lokalen Computer zurückgesetzt.

Gibt zurück

Type

Der Typ, der dem angegebenen Programmbezeichner (progID) zugeordnet ist, wenn progID ein gültiger Eintrag in der Registrierung ist und einem Typ zugeordnet ist; andernfalls null.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

progID ist null.

Beispiele

Im folgenden Beispiel wird ein Typ abgerufen, indem eine ProgID und ein Servername übergeben werden. Im Beispiel wird dann die ClassID im Zusammenhang mit der ProgID angezeigt oder eine Ausnahme ausgelöst, wenn die ProgID oder der Servername ungültig ist.

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

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

Hinweise

Diese Methode wird für die COM-Unterstützung bereitgestellt. Programm-IDs werden in Microsoft .NET Framework nicht verwendet, da sie durch das Konzept des Namespace ersetzt wurden.

Weitere Informationen

• GetProgIdForType(Type)

GetTypeFromProgID(String, String, Boolean)

Quelle:

Type.cs

Ruft den Typ ab, der dem angegebenen Programmbezeichner (ProgID) vom angegebenen Server zugeordnet ist, der angibt, ob eine Ausnahme ausgelöst werden soll, wenn beim Laden des Typs ein Fehler auftritt.

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

Parameter

progID

String

Die progID des abzurufenden Type.

server

String

Der Server, von dem der Typ geladen werden soll. Wenn der Servername nullist, wird diese Methode automatisch auf den lokalen Computer zurückgesetzt.

throwOnError

Boolean

true, um eine Ausnahme auszuwerfen, die auftritt.

-oder-

false alle ausnahmefehler zu ignorieren.

Gibt zurück

Type

Der Typ, der dem angegebenen Programmbezeichner (progID) zugeordnet ist, wenn progID ein gültiger Eintrag in der Registrierung ist und einem Typ zugeordnet ist; andernfalls null.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

progID ist null.

COMException

Die angegebene ProgID ist nicht registriert.

Beispiele

Im folgenden Beispiel wird ein Typ abgerufen, indem eine ProgID und ein Servername übergeben werden. Im Beispiel wird dann die ClassID im Zusammenhang mit der ProgID angezeigt, die angibt, ob eine Ausnahme ausgelöst werden soll, wenn die ProgID oder der Servername ungültig ist.

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

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

Hinweise

Diese Methode wird für die COM-Unterstützung bereitgestellt. Programm-IDs werden in Microsoft .NET Framework nicht verwendet, da sie durch das Konzept des Namespace ersetzt wurden.

Weitere Informationen

• GetProgIdForType(Type)
• TypeLoadException