Type.GetTypeFromProgID Type.GetTypeFromProgID Type.GetTypeFromProgID Type.GetTypeFromProgID Method

Определение

Возвращает тип, связанный с заданным идентификатором ProgID.Gets the type associated with the specified program identifier (ProgID).

Перегрузки

GetTypeFromProgID(String) GetTypeFromProgID(String) GetTypeFromProgID(String) GetTypeFromProgID(String)

Возвращает тип, связанный с указанным идентификатором ProgID, и возвращает значение NULL, если при загрузке объекта Type возникла ошибка.Gets the type associated with the specified program identifier (ProgID), returning null if an error is encountered while loading the Type.

GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean)

Возвращает тип, связанный с заданным идентификатором ProgID, позволяющим определить, будет ли выбрасываться исключение при происхождении ошибки во время загрузки типа.Gets the type associated with the specified program identifier (ProgID), specifying whether to throw an exception if an error occurs while loading the type.

GetTypeFromProgID(String, String) GetTypeFromProgID(String, String) GetTypeFromProgID(String, String) GetTypeFromProgID(String, String)

Возвращает с указанного сервера тип, связанный с заданным идентификатором ProgID, и возвращает значение NULL, если при загрузке типа произошла ошибка.Gets the type associated with the specified program identifier (progID) from the specified server, returning null if an error is encountered while loading the type.

GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean)

Возвращает с указанного сервера тип, связанный с заданным идентификатором progID, который позволяет определить, будет ли выбрасываться исключение при происхождении ошибки во время загрузки типа.Gets the type associated with the specified program identifier (progID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.

GetTypeFromProgID(String) GetTypeFromProgID(String) GetTypeFromProgID(String) GetTypeFromProgID(String)

Возвращает тип, связанный с указанным идентификатором ProgID, и возвращает значение NULL, если при загрузке объекта Type возникла ошибка.Gets the type associated with the specified program identifier (ProgID), returning null if an error is encountered while loading the Type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID);
static member GetTypeFromProgID : string -> Type
Public Shared Function GetTypeFromProgID (progID As String) As Type

Параметры

progID
String String String String

Идентификатор ProgID извлекаемого типа.The ProgID of the type to get.

Возвраты

Тип, связанный с указанным идентификатором ProgID, если идентификатор progID является допустимой записью в реестре и с ним связан определенный тип; в противном случае — значение null.The type associated with the specified ProgID, if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Исключения

Комментарии

Этот метод предназначен для поддержки модели COM.This method is provided for COM support. Идентификаторы ProgID не используются в Microsoft .NET Framework, так как они были заменены концепция пространства имен.ProgIDs are not used in the Microsoft .NET Framework because they have been superseded by the concept of namespace.

Безопасность

SecurityCriticalAttribute
Требует полного доверия для непосредственного вызывающего объекта.Requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean) GetTypeFromProgID(String, Boolean)

Возвращает тип, связанный с заданным идентификатором ProgID, позволяющим определить, будет ли выбрасываться исключение при происхождении ошибки во время загрузки типа.Gets the type associated with the specified program identifier (ProgID), specifying whether to throw an exception if an error occurs while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, bool throwOnError);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, bool throwOnError);
static member GetTypeFromProgID : string * bool -> Type
Public Shared Function GetTypeFromProgID (progID As String, throwOnError As Boolean) As Type

Параметры

progID
String String String String

Идентификатор ProgID извлекаемого типа.The ProgID of the type to get.

throwOnError
Boolean Boolean Boolean Boolean

Значение true для вызова любого возникшего исключения.true to throw any exception that occurs.

-или--or- Значение false для игнорирования всех происходящих исключений.false to ignore any exception that occurs.

Возвраты

Тип, связанный с указанным идентификатором ProgID, если идентификатор progID является допустимой записью в реестре и с ним связан определенный тип; в противном случае — значение null.The type associated with the specified program identifier (ProgID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Исключения

Указанный идентификатор ProgID не зарегистрирован.The specified ProgID is not registered.

Примеры

В следующем примере извлекается тип, передав идентификатор ProgID, указывая, следует ли исключение, если идентификатор ProgID является недопустимым.The following example retrieves a type by passing a ProgID, specifying whether to throw an exception if the ProgID is invalid. Затем отображается идентификатор ClassID, связанный с ProgID, а также любой соответствующее сообщение об ошибке.The example then displays the ClassID related to the ProgID, along with any applicable exception message.

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);
        }
    }
}
Imports System
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 'Main 
End Class 'MainApp

Комментарии

Этот метод предназначен для поддержки модели COM.This method is provided for COM support. Идентификаторы не используются в Microsoft .NET Framework, так как они были заменены концепция пространства имен.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Безопасность

SecurityCriticalAttribute
Требует полного доверия для непосредственного вызывающего объекта.Requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

GetTypeFromProgID(String, String) GetTypeFromProgID(String, String) GetTypeFromProgID(String, String) GetTypeFromProgID(String, String)

Возвращает с указанного сервера тип, связанный с заданным идентификатором ProgID, и возвращает значение NULL, если при загрузке типа произошла ошибка.Gets the type associated with the specified program identifier (progID) from the specified server, returning null if an error is encountered while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server);
static member GetTypeFromProgID : string * string -> Type
Public Shared Function GetTypeFromProgID (progID As String, server As String) As Type

Параметры

progID
String String String String

Идентификатор ProgID извлекаемого типа.The progID of the type to get.

server
String String String String

Сервер, с которого должен быть загружен тип.The server from which to load the type. Если в качестве имени сервера задано значение null, этот метод автоматически перейдет к поиску на локальном компьютере.If the server name is null, this method automatically reverts to the local machine.

Возвраты

Тип, связанный с заданным идентификатором ProgID, если идентификатор progID является допустимой записью в реестре и с ним связан определенный тип; в противном случае — значение null.The type associated with the specified program identifier (progID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Исключения

Примеры

В следующем примере извлекается тип путем передачи имени ProgID и сервера.The following example retrieves a type by passing a ProgID and server name. Затем в примере отображается идентификатор ClassID, связанный с ProgID, или создает исключение, если идентификатор ProgID или имя сервера является недопустимым.The example then displays the ClassID related to the ProgID, or throws an exception if the ProgID or the server name is invalid.

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);
        }		
    }
}
Imports System
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 'Main
End Class 'MainApp

Комментарии

Этот метод предназначен для поддержки модели COM.This method is provided for COM support. Идентификаторы не используются в Microsoft .NET Framework, так как они были заменены концепция пространства имен.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Безопасность

SecurityCriticalAttribute
Требует полного доверия для непосредственного вызывающего объекта.Requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean) GetTypeFromProgID(String, String, Boolean)

Возвращает с указанного сервера тип, связанный с заданным идентификатором progID, который позволяет определить, будет ли выбрасываться исключение при происхождении ошибки во время загрузки типа.Gets the type associated with the specified program identifier (progID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.

public:
 static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server, bool throwOnError);
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server, bool throwOnError);
static member GetTypeFromProgID : string * string * bool -> Type
Public Shared Function GetTypeFromProgID (progID As String, server As String, throwOnError As Boolean) As Type

Параметры

progID
String String String String

Идентификатор ProgID извлекаемого типа Type.The progID of the Type to get.

server
String String String String

Сервер, с которого должен быть загружен тип.The server from which to load the type. Если в качестве имени сервера задано значение null, этот метод автоматически перейдет к поиску на локальном компьютере.If the server name is null, this method automatically reverts to the local machine.

throwOnError
Boolean Boolean Boolean Boolean

Значение true для вызова любого возникшего исключения.true to throw any exception that occurs.

-или--or- Значение false для игнорирования всех происходящих исключений.false to ignore any exception that occurs.

Возвраты

Тип, связанный с заданным идентификатором ProgID, если идентификатор progID является допустимой записью в реестре и с ним связан определенный тип; в противном случае — значение null.The type associated with the specified program identifier (progID), if progID is a valid entry in the registry and a type is associated with it; otherwise, null.

Исключения

Указанный идентификатор progID не зарегистрирован.The specified progID is not registered.

Примеры

В следующем примере извлекается тип путем передачи имени ProgID и сервера.The following example retrieves a type by passing a ProgID and server name. Затем отображается идентификатор ClassID, связанный с ProgID, указывая, следует ли исключение, если идентификатор ProgID или имя сервера является недопустимым.The example then displays the ClassID related to the ProgID, specifying whether to throw an exception if the ProgID or the server name is invalid.

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);
        }
    }
}
Imports System
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 'Main 
End Class 'MainApp

Комментарии

Этот метод предназначен для поддержки модели COM.This method is provided for COM support. Идентификаторы не используются в Microsoft .NET Framework, так как они были заменены концепция пространства имен.Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.

Безопасность

SecurityCriticalAttribute
Требует полного доверия для непосредственного вызывающего объекта.Requires full trust for the immediate caller. Этот член не может использоваться частично доверенным или прозрачным кодом.This member cannot be used by partially trusted or transparent code.

Дополнительно

Применяется к