Type.GetTypeFromProgID Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá typ přidružený k zadanému identifikátoru programu (ProgID).

Přetížení

GetTypeFromProgID(String)	Získá typ přidružený k zadanému identifikátoru programu (ProgID), který vrací hodnotu null, pokud při načítání Typedojde k chybě .
GetTypeFromProgID(String, Boolean)	Získá typ přidružený k zadanému identifikátoru programu (ProgID), určující, zda se má vyvolat výjimku, pokud dojde k chybě při načítání typu.
GetTypeFromProgID(String, String)	Získá typ přidružený k zadanému identifikátoru programu (progID) ze zadaného serveru, který vrací hodnotu null, pokud při načítání typu dojde k chybě.
GetTypeFromProgID(String, String, Boolean)	Získá typ přidružený k zadanému identifikátoru programu (progID) ze zadaného serveru, který určuje, zda se má vyvolat výjimka, pokud dojde k chybě při načítání typu.

GetTypeFromProgID(String)

Zdroj:: Type.cs

Zdroj:: Type.cs

Zdroj:: Type.cs

Získá typ přidružený k zadanému identifikátoru programu (ProgID), který vrací hodnotu null, pokud při načítání Typedojde k chybě .

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

Identifikátor ProgID typu, který chcete získat.

Návraty

Type

Typ přidružený k zadanému Identifikátoru ProgID, pokud progID je platná položka v registru a typ je k němu přidružen; jinak null.

Atributy: SupportedOSPlatformAttribute SecurityCriticalAttribute

Výjimky

ArgumentException

progID je null.

Poznámky

Tato metoda je poskytována pro podporu modelu COM. Identifikátory ProgID se v rozhraní Microsoft .NET Framework nepoužívají, protože byly nahrazeny konceptem oboru názvů.

Viz také

GetProgIdForType(Type)

Platí pro

GetTypeFromProgID(String, Boolean)

Zdroj:: Type.cs

Zdroj:: Type.cs

Zdroj:: Type.cs

Získá typ přidružený k zadanému identifikátoru programu (ProgID), určující, zda se má vyvolat výjimku, pokud dojde k chybě při načítání typu.

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

Identifikátor ProgID typu, který chcete získat.

throwOnError: Boolean

true vyvolání jakékoli výjimky.

-nebo-

false ignorovat všechny výjimky, ke kterým dojde.

Návraty

Type

Typ přidružený k zadanému identifikátoru programu (ProgID), pokud progID je platná položka v registru a typ je k němu přidružen; jinak null.

Atributy: SupportedOSPlatformAttribute SecurityCriticalAttribute

Výjimky

ArgumentException

progID je null.

COMException

Zadaný identifikátor ProgID není zaregistrovaný.

Příklady

Následující příklad načte typ předáním ProgID a určuje, zda se má vyvolat výjimka, pokud je Identifikátor ProgID neplatný. V příkladu se pak zobrazí ID třídy související s Identifikátorem ProgID spolu s případnou zprávou o výjimce.

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

Poznámky

Tato metoda je poskytována pro podporu modelu COM. ID programů se v rozhraní Microsoft .NET Framework nepoužívají, protože byly nahrazeny konceptem oboru názvů.

Viz také

GetProgIdForType(Type)

Platí pro

GetTypeFromProgID(String, String)

Zdroj:: Type.cs

Zdroj:: Type.cs

Zdroj:: Type.cs

Získá typ přidružený k zadanému identifikátoru programu (progID) ze zadaného serveru, který vrací hodnotu null, pokud při načítání typu dojde k chybě.

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

Identifikátor progID typu, který chcete získat.

server: String

Server, ze kterého se má typ načíst. Pokud je název serveru null, tato metoda se automaticky vrátí na místní počítač.

Návraty

Type

Typ přidružený k zadanému identifikátoru programu (progID), pokud progID je platná položka v registru a typ je k němu přidružen; jinak null.

Atributy: SupportedOSPlatformAttribute SecurityCriticalAttribute

Výjimky

ArgumentException

progID je null.

Příklady

Následující příklad načte typ předáním Identifikátoru ProgID a názvu serveru. Příklad pak zobrazí ID třídy související s ProgID nebo vyvolá výjimku, pokud je Identifikátor ProgID nebo název serveru neplatný.

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

Poznámky

Tato metoda je poskytována pro podporu modelu COM. ID programů se v rozhraní Microsoft .NET Framework nepoužívají, protože byly nahrazeny konceptem oboru názvů.

Viz také

GetProgIdForType(Type)

Platí pro

GetTypeFromProgID(String, String, Boolean)

Zdroj:: Type.cs

Zdroj:: Type.cs

Zdroj:: Type.cs

Získá typ přidružený k zadanému identifikátoru programu (progID) ze zadaného serveru, který určuje, zda se má vyvolat výjimka, pokud dojde k chybě při načítání typu.

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

ProgID Type získat.

server: String

Server, ze kterého se má typ načíst. Pokud je název serveru null, tato metoda se automaticky vrátí na místní počítač.

throwOnError: Boolean

true vyvolání jakékoli výjimky.

-nebo-

false ignorovat všechny výjimky, ke kterým dojde.

Návraty

Type

Typ přidružený k zadanému identifikátoru programu (progID), pokud progID je platná položka v registru a typ je k němu přidružen; jinak null.

Atributy: SupportedOSPlatformAttribute SecurityCriticalAttribute

Výjimky

ArgumentException

progID je null.

COMException

Zadaný identifikátor progID není zaregistrovaný.

Příklady

Následující příklad načte typ předáním Identifikátoru ProgID a názvu serveru. V příkladu se pak zobrazí ID třídy související s ProgID a určuje, jestli se má vyvolat výjimka, pokud je identifikátor ProgID nebo název serveru neplatný.

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

Poznámky

Tato metoda je poskytována pro podporu modelu COM. ID programů se v rozhraní Microsoft .NET Framework nepoužívají, protože byly nahrazeny konceptem oboru názvů.

Viz také

Platí pro

Sdílet prostřednictvím

Type.GetTypeFromProgID Metoda

Definice

Přetížení

GetTypeFromProgID(String)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetTypeFromProgID(String, Boolean)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

GetTypeFromProgID(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

GetTypeFromProgID(String, String, Boolean)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály