Type.GetTypeFromProgID メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したプログラム識別子 (ProgID) に関連付けられている型を取得します。
| GetTypeFromProgID(String) |
指定したプログラム識別子 (ProgID) に関連付けられている型を取得し、Typeの読み込み中にエラーが発生した場合は null を返します。 |
| GetTypeFromProgID(String, Boolean) |
指定したプログラム識別子 (ProgID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合に例外をスローするかどうかを指定します。 |
| GetTypeFromProgID(String, String) |
指定したサーバーから、指定したプログラム識別子 (progID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合は null を返します。 |
| GetTypeFromProgID(String, String, Boolean) |
指定したサーバーから、指定したプログラム識別子 (progID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合に例外をスローするかどうかを指定します。 |
- ソース:
- Type.cs
- ソース:
- Type.cs
- ソース:
- Type.cs
指定したプログラム識別子 (ProgID) に関連付けられている型を取得し、Typeの読み込み中にエラーが発生した場合は null を返します。
public:
static Type ^ GetTypeFromProgID(System::String ^ progID);C#
public static Type? GetTypeFromProgID (string progID);C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID (string progID);C#
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID);C#
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 -> TypePublic 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 |
- ソース:
- Type.cs
- ソース:
- Type.cs
- ソース:
- Type.cs
指定したプログラム識別子 (ProgID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合に例外をスローするかどうかを指定します。
public:
static Type ^ GetTypeFromProgID(System::String ^ progID, bool throwOnError);C#
public static Type? GetTypeFromProgID (string progID, bool throwOnError);C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID (string progID, bool throwOnError);C#
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, bool throwOnError);C#
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 -> TypePublic Shared Function GetTypeFromProgID (progID As String, throwOnError As Boolean) As Typeパラメーター
- progID
- String
取得する型の ProgID。
戻り値
指定したプログラム識別子 (ProgID) に関連付けられている型 (progID がレジストリの有効なエントリであり、型がそれに関連付けられている場合)。それ以外の場合は、nullします。
- 属性
例外
progID は nullです。
指定した ProgID が登録されていません。
例
次の例では、ProgID が無効な場合に例外をスローするかどうかを指定して、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 );
}
}
C#
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 |
- ソース:
- Type.cs
- ソース:
- Type.cs
- ソース:
- Type.cs
指定したサーバーから、指定したプログラム識別子 (progID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合は null を返します。
public:
static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server);C#
public static Type? GetTypeFromProgID (string progID, string? server);C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID (string progID, string? server);C#
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server);C#
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 -> TypePublic 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 またはサーバー名が無効な場合に例外をスローします。
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 );
}
}
C#
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 |
- ソース:
- Type.cs
- ソース:
- Type.cs
- ソース:
- Type.cs
指定したサーバーから、指定したプログラム識別子 (progID) に関連付けられている型を取得し、型の読み込み中にエラーが発生した場合に例外をスローするかどうかを指定します。
public:
static Type ^ GetTypeFromProgID(System::String ^ progID, System::String ^ server, bool throwOnError);C#
public static Type? GetTypeFromProgID (string progID, string? server, bool throwOnError);C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static Type? GetTypeFromProgID (string progID, string? server, bool throwOnError);C#
[System.Security.SecurityCritical]
public static Type GetTypeFromProgID (string progID, string server, bool throwOnError);C#
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 -> TypePublic 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 またはサーバー名が無効な場合に例外をスローするかどうかを指定して、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 );
}
}
C#
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 |
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。