Skip to main content
.NET Framework Class Library
X509Certificate..::.GetName Method

Note: This API is now obsolete.

Returns the name of the principal to which the certificate was issued.

Namespace: System.Security.Cryptography.X509Certificates
Assembly: mscorlib (in mscorlib.dll)
Syntax
<ObsoleteAttribute("This method has been deprecated.  Please use the Subject property instead.  http://go.microsoft.com/fwlink/?linkid=14202")> _
Public Overridable Function GetName As String
[ObsoleteAttribute("This method has been deprecated.  Please use the Subject property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual string GetName()
[ObsoleteAttribute(L"This method has been deprecated.  Please use the Subject property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public:
virtual String^ GetName()
[<ObsoleteAttribute("This method has been deprecated.  Please use the Subject property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
abstract GetName : unit -> string 
[<ObsoleteAttribute("This method has been deprecated.  Please use the Subject property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
override GetName : unit -> string 

Return Value

Type: System..::.String
The name of the principal to which the certificate was issued.
Exceptions
ExceptionCondition
CryptographicException

The certificate context is invalid.

Examples

The following example uses the GetName method to return the name of a certificate's principal and displays it to the console.


Imports System
Imports System.Security.Cryptography.X509Certificates




Public Class X509


   Public Shared Sub Main()

      ' The path to the certificate.
      Dim Certificate As String = "Certificate.cer"

      ' Load the certificate into an X509Certificate object.
      Dim cert As X509Certificate = X509Certificate.CreateFromCertFile(Certificate)

      ' Get the value.
      Dim results As String = cert.GetName()

      ' Display the value to the console.
      Console.WriteLine(results)
   End Sub 
End Class 




using System;
using System.Security.Cryptography.X509Certificates;


public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate =  "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = X509Certificate.CreateFromCertFile(Certificate);

        // Get the value.
        string results = cert.GetName();

        // Display the value to the console.
        Console.WriteLine(results);

    }

}


using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{

   // The path to the certificate.
   String^ Certificate = "Certificate.cer";

   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = X509Certificate::CreateFromCertFile( Certificate );

   // Get the value.
   String^ results = cert->GetName();

   // Display the value to the console.
   Console::WriteLine( results );
}


Version Information

.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2

.NET Framework Client Profile

Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.