Type.GetTypeFromProgID 메서드
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 프로그램 식별자(ProgID)와 연결된 형식을 가져옵니다.
GetTypeFromProgID(String) |
지정된 프로그램 식별자(ProgID)와 연결된 형식을 가져오며, Type로드하는 동안 오류가 발생하면 null을 반환합니다. |
GetTypeFromProgID(String, Boolean) |
지정된 프로그램 식별자(ProgID)와 연결된 형식을 가져오며, 형식을 로드하는 동안 오류가 발생할 경우 예외를 throw할지 여부를 지정합니다. |
GetTypeFromProgID(String, String) |
지정된 서버에서 지정된 프로그램 식별자(progID)와 연결된 형식을 가져오고, 형식을 로드하는 동안 오류가 발생하면 null을 반환합니다. |
GetTypeFromProgID(String, String, Boolean) |
지정된 서버에서 지정된 프로그램 식별자(progID)와 연결된 형식을 가져오며, 형식을 로드하는 동안 오류가 발생할 경우 예외를 throw할지 여부를 지정합니다. |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
지정된 프로그램 식별자(ProgID)와 연결된 형식을 가져오며, Type로드하는 동안 오류가 발생하면 null을 반환합니다.
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
매개 변수
- progID
- String
가져올 형식의 ProgID입니다.
반환
progID
레지스트리의 유효한 항목이고 형식이 연결된 경우 지정된 ProgID와 연결된 형식입니다. 그렇지 않으면 null
.
- 특성
예외
progID
null
.
설명
이 메서드는 COM 지원을 위해 제공됩니다. ProgID는 네임스페이스 개념으로 대체되었기 때문에 Microsoft .NET Framework에서 사용되지 않습니다.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
지정된 프로그램 식별자(ProgID)와 연결된 형식을 가져오며, 형식을 로드하는 동안 오류가 발생할 경우 예외를 throw할지 여부를 지정합니다.
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
매개 변수
- progID
- String
가져올 형식의 ProgID입니다.
반환
지정된 프로그램 식별자(ProgID)와 연결된 형식이며, progID
레지스트리의 유효한 항목이고 형식이 연결된 경우 그렇지 않으면 null
.
- 특성
예외
progID
null
.
지정된 ProgID가 등록되지 않았습니다.
예제
다음 예제에서는 ProgID가 잘못된 경우 예외를 throw할지 여부를 지정하는 ProgID를 전달하여 형식을 검색합니다. 그런 다음 해당 예외 메시지와 함께 ProgID와 관련된 ClassID를 표시하는 예제입니다.
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
설명
이 메서드는 COM 지원을 위해 제공됩니다. 프로그램 ID는 네임스페이스 개념으로 대체되었기 때문에 Microsoft .NET Framework에서 사용되지 않습니다.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
지정된 서버에서 지정된 프로그램 식별자(progID)와 연결된 형식을 가져오고, 형식을 로드하는 동안 오류가 발생하면 null을 반환합니다.
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
매개 변수
- progID
- String
가져올 형식의 progID입니다.
- server
- String
형식을 로드할 서버입니다. 서버 이름이 null
경우 이 메서드는 자동으로 로컬 컴퓨터로 되돌려집니다.
반환
지정된 프로그램 식별자(progID)와 연결된 형식이며, progID
레지스트리의 유효한 항목이고 형식이 연결된 경우 그렇지 않으면 null
.
- 특성
예외
progID
null
.
예제
다음 예제에서는 ProgID 및 서버 이름을 전달하여 형식을 검색합니다. 그런 다음 ProgID와 관련된 ClassID를 표시하거나 ProgID 또는 서버 이름이 잘못된 경우 예외를 throw합니다.
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
설명
이 메서드는 COM 지원을 위해 제공됩니다. 프로그램 ID는 네임스페이스 개념으로 대체되었기 때문에 Microsoft .NET Framework에서 사용되지 않습니다.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
지정된 서버에서 지정된 프로그램 식별자(progID)와 연결된 형식을 가져오며, 형식을 로드하는 동안 오류가 발생할 경우 예외를 throw할지 여부를 지정합니다.
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
매개 변수
- server
- String
형식을 로드할 서버입니다. 서버 이름이 null
경우 이 메서드는 자동으로 로컬 컴퓨터로 되돌려집니다.
반환
지정된 프로그램 식별자(progID)와 연결된 형식이며, progID
레지스트리의 유효한 항목이고 형식이 연결된 경우 그렇지 않으면 null
.
- 특성
예외
progID
null
.
지정된 progID가 등록되지 않았습니다.
예제
다음 예제에서는 ProgID 및 서버 이름을 전달하여 형식을 검색합니다. 그런 다음 ProgID 또는 서버 이름이 잘못된 경우 예외를 throw할지 여부를 지정하여 ProgID와 관련된 ClassID를 표시합니다.
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
설명
이 메서드는 COM 지원을 위해 제공됩니다. 프로그램 ID는 네임스페이스 개념으로 대체되었기 때문에 Microsoft .NET Framework에서 사용되지 않습니다.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.