Type.GetTypeFromProgID Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Ö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ıyla (ProgID) 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 Typeyüklenirken bir hatayla karşılaşılırsa null döndürür.
GetTypeFromProgID(String, Boolean)	Belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır ve tür yüklenirken bir hata oluşursa özel durum oluşturup oluşturmayacağını belirtir.
GetTypeFromProgID(String, String)	Belirtilen sunucudaki belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve tür yüklenirken bir hatayla karşılaşılırsa null döndürür.
GetTypeFromProgID(String, String, Boolean)	Belirtilen sunucudaki belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklenirken bir hata oluşursa özel durum oluşturup oluşturmayacağını belirtir.

GetTypeFromProgID(String)

Kaynak:: Type.cs

Kaynak:: Type.cs

Kaynak:: Type.cs

belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır ve Typeyüklenirken bir hatayla karşılaşılırsa null 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

Alınacak türün ProgID değeri.

Döndürülenler

Type

Belirtilen ProgID ile ilişkilendirilmiş tür, progID kayıt defterinde geçerli bir girdiyse ve bununla ilişkili bir türse; aksi takdirde null.

Öznitelikler: SupportedOSPlatformAttribute SecurityCriticalAttribute

Özel durumlar

ArgumentException

progID null.

Açıklamalar

Bu yöntem COM desteği için sağlanır. ProgID'ler, ad alanı kavramıyla değiştirildiklerinden Microsoft .NET Framework'te kullanılmaz.

Ayrıca bkz.

GetProgIdForType(Type)

Şunlara uygulanır

GetTypeFromProgID(String, Boolean)

Kaynak:: Type.cs

Kaynak:: Type.cs

Kaynak:: Type.cs

Belirtilen program tanımlayıcısı (ProgID) ile ilişkili türü alır ve tür yüklenirken bir hata oluşursa özel durum oluşturup oluşturmayacağı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

Alınacak türün ProgID değeri.

throwOnError: Boolean

Oluşan özel durumları true.

-veya-

Oluşan özel durumları yoksaymak false.

Döndürülenler

Type

progID kayıt defterinde geçerli bir girdiyse ve onunla ilişkili bir türse, belirtilen program tanımlayıcısıyla (ProgID) ilişkili tür; aksi takdirde null.

Öznitelikler: SupportedOSPlatformAttribute SecurityCriticalAttribute

Özel durumlar

ArgumentException

progID null.

COMException

Belirtilen ProgID kayıtlı değil.

Örnekler

Aşağıdaki örnek, ProgID geçersizse özel durum oluşturup oluşturmayacağını belirterek bir ProgID geçirerek bir tür alır. Örnek daha sonra ProgID ile ilgili ClassID'yi ve ilgili özel durum iletisini 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);
        }
    }
}

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

Açıklamalar

Bu yöntem COM desteği için sağlanır. Ad alanı kavramıyla değiştirilen program kimlikleri Microsoft .NET Framework'te kullanılmaz.

Ayrıca bkz.

GetProgIdForType(Type)

Şunlara uygulanır

GetTypeFromProgID(String, String)

Kaynak:: Type.cs

Kaynak:: Type.cs

Kaynak:: Type.cs

Belirtilen sunucudaki belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve tür yüklenirken bir hatayla karşılaşılırsa 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

Alınacak türün progID değeri.

server: String

Türün yüklendiği sunucu. Sunucu adı nullise, bu yöntem otomatik olarak yerel makineye geri döner.

Döndürülenler

Type

progID kayıt defterinde geçerli bir girdiyse ve onunla bir tür ilişkilendirildiyse, belirtilen program tanımlayıcısıyla (progID) ilişkili tür; aksi takdirde null.

Öznitelikler: SupportedOSPlatformAttribute SecurityCriticalAttribute

Özel durumlar

ArgumentException

progID null.

Örnekler

Aşağıdaki örnek, bir ProgID ve sunucu adı geçirerek bir tür alı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);
        }		
    }
}

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

Açıklamalar

Bu yöntem COM desteği için sağlanır. Ad alanı kavramıyla değiştirilen program kimlikleri Microsoft .NET Framework'te kullanılmaz.

Ayrıca bkz.

GetProgIdForType(Type)

Şunlara uygulanır

GetTypeFromProgID(String, String, Boolean)

Kaynak:: Type.cs

Kaynak:: Type.cs

Kaynak:: Type.cs

Belirtilen sunucudaki belirtilen program tanımlayıcısı (progID) ile ilişkili türü alır ve türü yüklenirken bir hata oluşursa özel durum oluşturup oluşturmayacağı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

progID: String

Alınacak Type progID değeri.

server: String

Türün yüklendiği sunucu. Sunucu adı nullise, bu yöntem otomatik olarak yerel makineye geri döner.

throwOnError: Boolean

Oluşan özel durumları true.

-veya-

Oluşan özel durumları yoksaymak false.

Döndürülenler

Type

progID kayıt defterinde geçerli bir girdiyse ve onunla bir tür ilişkilendirildiyse, belirtilen program tanımlayıcısıyla (progID) ilişkili tür; aksi takdirde null.

Öznitelikler: SupportedOSPlatformAttribute SecurityCriticalAttribute

Özel durumlar

ArgumentException

progID null.

COMException

Belirtilen progID kayıtlı değil.

Örnekler

Aşağıdaki örnek, bir ProgID ve sunucu adı geçirerek bir tür alır. Örnek daha sonra ProgID ile ilgili ClassID değerini görüntüler ve ProgID veya sunucu adı geçersizse özel durum oluşturup oluşturmayacağı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);
        }
    }
}

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

Açıklamalar

Bu yöntem COM desteği için sağlanır. Ad alanı kavramıyla değiştirilen program kimlikleri Microsoft .NET Framework'te kullanılmaz.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

Type.GetTypeFromProgID Yöntem

Tanım

Aşırı Yüklemeler

GetTypeFromProgID(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetTypeFromProgID(String, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetTypeFromProgID(String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetTypeFromProgID(String, String, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar