Type.GetTypeFromProgID Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera typ skojarzony z określonym identyfikatorem programu (ProgID).

Przeciążenia

GetTypeFromProgID(String)	Pobiera typ skojarzony z określonym identyfikatorem programu (ProgID), zwracając wartość null w przypadku napotkania błędu podczas ładowania Type .
GetTypeFromProgID(String, Boolean)	Pobiera typ skojarzony z określonym identyfikatorem programu (ProgID), określając, czy w przypadku wystąpienia błędu podczas ładowania typu ma być zgłaszany wyjątek.
GetTypeFromProgID(String, String)	Pobiera typ skojarzony z określonym identyfikatorem programu (progID) z określonego serwera, zwraca wartość null, jeśli podczas ładowania typu wystąpi błąd.
GetTypeFromProgID(String, String, Boolean)	Pobiera typ skojarzony z określonym identyfikatorem programu (progID) z określonego serwera, określając, czy w przypadku wystąpienia błędu podczas ładowania typu ma być zgłaszany wyjątek.

GetTypeFromProgID(String)

Pobiera typ skojarzony z określonym identyfikatorem programu (ProgID), zwracając wartość null w przypadku napotkania błędu podczas ładowania Type .

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

public static Type? GetTypeFromProgID (string progID);

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

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

public static Type GetTypeFromProgID (string progID);

static member GetTypeFromProgID : string -> Type

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

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

Public Shared Function GetTypeFromProgID (progID As String) As Type

Parametry

progID: String

Identyfikator ProgID typu do uzyskania.

Zwraca

Type

Typ skojarzony z określonym progID, jeśli jest prawidłowym wpisem w rejestrze i typ jest skojarzony z nim; w przeciwnym razie progID null .

Atrybuty: SupportedOSPlatformAttribute SecurityCriticalAttribute

Wyjątki

ArgumentException

progID to null.

Uwagi

Ta metoda umożliwia obsługę COM. ProgID nie są używane w witrynie Microsoft .NET Framework, ponieważ zostały one nadsyłane przez koncepcję przestrzeni nazw.

Zobacz też

GetProgIdForType(Type)

Dotyczy

GetTypeFromProgID(String, Boolean)

Pobiera typ skojarzony z określonym identyfikatorem programu (ProgID), określając, czy w przypadku wystąpienia błędu podczas ładowania typu ma być zgłaszany wyjątek.

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

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

static member GetTypeFromProgID : string * bool -> Type

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

Parametry

progID: String

Identyfikator ProgID typu do uzyskania.

throwOnError: Boolean

true w celu zgłaszania dowolnego wyjątku, który wystąpi.

-lub- false , aby zignorować wszelkie wyjątki, które wystąpią.

Zwraca

Type

Typ skojarzony z określonym identyfikatorem programu (ProgID), jeśli jest prawidłowym wpisem w rejestrze, a typ jest skojarzony z nim; w przeciwnym razie progID null .

Atrybuty: SupportedOSPlatformAttribute SecurityCriticalAttribute

Wyjątki

ArgumentException

progID to null.

COMException

Określony progID nie jest zarejestrowany.

Przykłady

Poniższy przykład pobiera typ, przekazując progID, określając, czy zgłosić wyjątek, jeśli ProgID jest nieprawidłowy. W przykładzie zostanie wyświetlony identyfikator klasy powiązany z progID wraz z dowolnym komunikatem o wyjątku.

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

Uwagi

Ta metoda umożliwia obsługę COM. Identyfikatory programów nie są używane w programie Microsoft .NET Framework ponieważ zostały one nadsyłane przez koncepcję przestrzeni nazw.

Zobacz też

GetProgIdForType(Type)

Dotyczy

GetTypeFromProgID(String, String)

Pobiera typ skojarzony z określonym identyfikatorem programu (progID) z określonego serwera, zwraca wartość null, jeśli podczas ładowania typu wystąpi błąd.

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

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

static member GetTypeFromProgID : string * string -> Type

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

Parametry

progID: String

Identyfikator progID typu do uzyskania.

server: String

Serwer, z którego można załadować typ. Jeśli nazwa serwera to null , ta metoda automatycznie przywraca komputer lokalny.

Zwraca

Type

Typ skojarzony z określonym identyfikatorem programu (progID), jeśli jest prawidłowym wpisem w rejestrze, a typ jest skojarzony z nim; w przeciwnym razie progID null .

Atrybuty: SupportedOSPlatformAttribute SecurityCriticalAttribute

Wyjątki

ArgumentException

prodID to null.

Przykłady

W poniższym przykładzie typ jest pobierany przez przekazanie identyfikatora ProgID i nazwy serwera. W przykładzie jest następnie wyświetlana wartość ClassID powiązana z progidem lub zgłaszany jest wyjątek, jeśli identyfikator ProgID lub nazwa serwera są nieprawidłowe.

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

Uwagi

Ta metoda umożliwia obsługę COM. Identyfikatory programów nie są używane w programie Microsoft .NET Framework ponieważ zostały one nadsyłane przez koncepcję przestrzeni nazw.

Zobacz też

GetProgIdForType(Type)

Dotyczy

GetTypeFromProgID(String, String, Boolean)

Pobiera typ skojarzony z określonym identyfikatorem programu (progID) z określonego serwera, określając, czy w przypadku wystąpienia błędu podczas ładowania typu ma być zgłaszany wyjątek.

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

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

Parametry

progID: String

Identyfikator progID do Type uzyskania.

server: String

Serwer, z którego można załadować typ. Jeśli nazwa serwera to null , ta metoda automatycznie przywraca komputer lokalny.

throwOnError: Boolean

true w celu zgłaszania dowolnego wyjątku, który wystąpi.

-lub- false , aby zignorować wszelkie wyjątki, które wystąpią.

Zwraca

Type

Typ skojarzony z określonym identyfikatorem programu (progID), jeśli jest prawidłowym wpisem w rejestrze, a typ jest skojarzony z nim; w przeciwnym razie progID null .

Atrybuty: SupportedOSPlatformAttribute SecurityCriticalAttribute

Wyjątki

ArgumentException

progID to null.

COMException

Określony progID nie jest zarejestrowany.

Przykłady

W poniższym przykładzie typ jest pobierany przez przekazanie identyfikatora ProgID i nazwy serwera. Następnie w przykładzie jest wyświetlany identyfikator klasy powiązany z progID, określając, czy zgłosić wyjątek, jeśli identyfikator ProgID lub nazwa serwera jest nieprawidłowa.

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

Uwagi

Ta metoda umożliwia obsługę COM. Identyfikatory programów nie są używane w programie Microsoft .NET Framework ponieważ zostały one nadsyłane przez koncepcję przestrzeni nazw.

Zobacz też

Dotyczy

Type.GetTypeFromProgID Metoda

Definicja

Przeciążenia

GetTypeFromProgID(String)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

GetTypeFromProgID(String, Boolean)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

GetTypeFromProgID(String, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

GetTypeFromProgID(String, String, Boolean)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby