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(프로그램 식별자)와 연관된 형식을 가져오고 Type을 로드하는 동안 오류가 발생하면 null을 반환합니다.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(프로그램 식별자)와 연관된 형식을 가져오고 형식을 로드하는 동안 오류가 발생하면 예외를 throw할지를 지정합니다.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(프로그램 식별자)와 연관된 형식을 지정된 서버에서 가져오고, 형식을 로드하는 동안 오류가 발생하면 예외를 throw할지를 지정합니다.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(프로그램 식별자)와 연관된 형식을 가져오고 Type을 로드하는 동안 오류가 발생하면 null을 반환합니다.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(프로그램 식별자)와 연관된 형식을 가져오고 형식을 로드하는 동안 오류가 발생하면 예외를 throw할지를 지정합니다.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

발생하는 예외를 모두 throw하려면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가 유효 하지 않은 경우 예외를 throw 할지를 지정 된 ProgID를 전달 하 여 형식을 검색 합니다.The following example retrieves a type by passing a ProgID, specifying whether to throw an exception if the ProgID is invalid. 다음 예제에서는 모든 적절 한 예외 메시지와 함께 ProgID와 관련 된 ClassID를 표시 합니다.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);
        }
    }
}
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

설명

이 메서드는 제공 하는 COM 지원에 대 한 합니다.This method is provided for COM support. 네임 스페이스의 개념에 의해 대체 하기 때문에 Microsoft.NET Framework의 프로그램 Id는 사용 되지 않습니다.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. 예제는 다음의 ProgID와 관련 된 ClassID를 표시 또는 ProgID 또는 서버 이름이 유효 하지 않은 경우 예외를 throw 합니다.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);
        }		
    }
}
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

설명

이 메서드는 제공 하는 COM 지원에 대 한 합니다.This method is provided for COM support. 네임 스페이스의 개념에 의해 대체 하기 때문에 Microsoft.NET Framework의 프로그램 Id는 사용 되지 않습니다.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(프로그램 식별자)와 연관된 형식을 지정된 서버에서 가져오고, 형식을 로드하는 동안 오류가 발생하면 예외를 throw할지를 지정합니다.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

가져올 Type의 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.

throwOnError
Boolean Boolean Boolean Boolean

발생하는 예외를 모두 throw하려면 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. 다음 예제를 ProgID 또는 서버 이름이 유효 하지 않은 경우 예외를 throw 할지를 지정 된 ProgID와 관련 된 ClassID를 표시 합니다.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);
        }
    }
}
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

설명

이 메서드는 제공 하는 COM 지원에 대 한 합니다.This method is provided for COM support. 네임 스페이스의 개념에 의해 대체 하기 때문에 Microsoft.NET Framework의 프로그램 Id는 사용 되지 않습니다.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.

추가 정보

적용 대상