Type.GetTypeFromProgID Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır.
Aşırı Yüklemeler
GetTypeFromProgID(String) |
Belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır ve yüklenirken bir hatayla karşılaşıldı ise null Type döndürür. |
GetTypeFromProgID(String, Boolean) |
Belirtilen program tanımlayıcısı (ProgID) ile ilişkilendirilmiş türü alır ve türü yüklerken bir hata oluşursa özel durum verilip oluşmay olmadığını belirtir. |
GetTypeFromProgID(String, String) |
Belirtilen sunucudan belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklerken bir hatayla karşılaşırsanız null döndürür. |
GetTypeFromProgID(String, String, Boolean) |
Belirtilen sunucudan belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklerken bir hata oluşursa bir özel durum verilip oluşmay olmadığını belirtir. |
GetTypeFromProgID(String)
Belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır ve yüklenirken bir hatayla karşılaşıldı ise null Type döndürür.
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
Parametreler
- progID
- String
Elde etmek istediğiniz türün ProgID'si.
Döndürülenler
Kayıt defterinde geçerli bir girişse ve bir tür ile ilişkili ise belirtilen ProgID ile ilişkili tür; aksi progID
takdirde, null
.
- Öznitelikler
Özel durumlar
progID
, null
değeridir.
Açıklamalar
Bu yöntem COM desteği için sağlanmıştır. ProgID'ler Microsoft .NET Framework ad alanı kavramı tarafından yenisi ekli olduğundan kullanılmaz.
Ayrıca bkz.
Şunlara uygulanır
GetTypeFromProgID(String, Boolean)
Belirtilen program tanımlayıcısı (ProgID) ile ilişkilendirilmiş türü alır ve türü yüklerken bir hata oluşursa özel durum verilip oluşmay olmadığını belirtir.
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
Parametreler
- progID
- String
Elde etmek istediğiniz türün ProgID'si.
- throwOnError
- Boolean
true
oluşan tüm özel durumları atmak için.
-veya-
false
oluşan özel durumları yoksaymak için.
Döndürülenler
Belirtilen program tanımlayıcısı (ProgID) ile ilişkili tür, kayıt defterinde geçerli bir girişse ve bir tür ile ilişkili ise; aksi progID
takdirde, null
.
- Öznitelikler
Özel durumlar
progID
, null
değeridir.
Belirtilen ProgID kayıtlı değil.
Örnekler
Aşağıdaki örnek, ProgID geçersizse bir özel durum olup olmadığını belirterek bir ProgID geçerek bir tür verir. Örnek daha sonra ProgID ile ilgili ClassID'yi ve uygulanabilir özel durum iletilerini görüntüler.
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
Açıklamalar
Bu yöntem COM desteği için sağlanmıştır. Program kimlikleri, ad alanı .NET Framework yenisi ekli olduğundan Microsoft .NET Framework'de kullanılmaz.
Ayrıca bkz.
Şunlara uygulanır
GetTypeFromProgID(String, String)
Belirtilen sunucudan belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklerken bir hatayla karşılaşırsanız null döndürür.
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
Parametreler
- progID
- String
Elde etmek istediğiniz türün progID'si.
- server
- String
Türün yükleneceği kaynak olan sunucu. Sunucu adı null
ise, bu yöntem otomatik olarak yerel makineye geri döner.
Döndürülenler
Belirtilen program tanımlayıcısı (progID) ile ilişkili tür, kayıt defterinde geçerli bir girişse ve bir tür ile ilişkili ise; aksi progID
takdirde, null
.
- Öznitelikler
Özel durumlar
prodID
, null
değeridir.
Örnekler
Aşağıdaki örnek Bir ProgID ve sunucu adı geçerek bir tür alınır. Örnek daha sonra ProgID ile ilgili ClassID'yi görüntüler veya ProgID veya sunucu adı geçersizse bir özel durum oluşturur.
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
Açıklamalar
Bu yöntem COM desteği için sağlanmıştır. Program kimlikleri, ad alanı .NET Framework yenisi ekli olduğundan Microsoft .NET Framework'de kullanılmaz.
Ayrıca bkz.
Şunlara uygulanır
GetTypeFromProgID(String, String, Boolean)
Belirtilen sunucudan belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklerken bir hata oluşursa bir özel durum verilip oluşmay olmadığını belirtir.
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
Parametreler
- server
- String
Türün yükleneceği kaynak olan sunucu. Sunucu adı null
ise, bu yöntem otomatik olarak yerel makineye geri döner.
- throwOnError
- Boolean
true
oluşan tüm özel durumları atmak için.
-veya-
false
oluşan özel durumları yoksaymak için.
Döndürülenler
Belirtilen program tanımlayıcısı (progID) ile ilişkili tür, kayıt defterinde geçerli bir girişse ve bir tür ile ilişkili ise; aksi progID
takdirde, null
.
- Öznitelikler
Özel durumlar
progID
, null
değeridir.
Belirtilen progID kayıtlı değil.
Örnekler
Aşağıdaki örnek Bir ProgID ve sunucu adı geçerek bir tür alınır. Örnek daha sonra ProgID ile ilgili ClassID'yi görüntüler ve ProgID veya sunucu adı geçersizse bir özel durum olup olmadığını belirtir.
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
Açıklamalar
Bu yöntem COM desteği için sağlanmıştır. Program kimlikleri, ad alanı .NET Framework yenisi ekli olduğundan Microsoft .NET Framework'de kullanılmaz.