X509Certificate 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供協助您使用 X.509 v.3 憑證的方法。
public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializablepublic ref class X509Certificate : IDisposablepublic ref class X509Certificatepublic ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializablepublic class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializablepublic class X509Certificate : IDisposable[System.Serializable]
public class X509Certificate[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializabletype X509Certificate = class
interface IDisposable
interface IDeserializationCallback
interface ISerializabletype X509Certificate = class
interface IDisposabletype X509Certificate = class
interface IDisposable
interface ISerializable
interface IDeserializationCallback[<System.Serializable>]
type X509Certificate = class[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
interface IDeserializationCallback
interface ISerializable[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
interface IDisposable
interface IDeserializationCallback
interface ISerializablePublic Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializablePublic Class X509Certificate
Implements IDisposablePublic Class X509CertificatePublic Class X509Certificate
Implements IDeserializationCallback, ISerializable- 繼承
-
X509Certificate
- 衍生
- 屬性
- 實作
範例
下列範例會從檔案載入 X.509 憑證、呼叫 ToString 方法，並將結果顯示至主控台。
using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
// The path to the certificate.
String^ Certificate = L"Certificate.cer";
// Load the certificate into an X509Certificate object.
X509Certificate^ cert = gcnew X509Certificate( Certificate );
// Get the value.
String^ resultsTrue = cert->ToString( true );
// Display the value to the console.
Console::WriteLine( resultsTrue );
// Get the value.
String^ resultsFalse = cert->ToString( false );
// Display the value to the console.
Console::WriteLine( resultsFalse );
}
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 = new X509Certificate(Certificate);
// Get the value.
string resultsTrue = cert.ToString(true);
// Display the value to the console.
Console.WriteLine(resultsTrue);
// Get the value.
string resultsFalse = cert.ToString(false);
// Display the value to the console.
Console.WriteLine(resultsFalse);
}
}
Imports System.Security.Cryptography.X509Certificates
Module X509
Sub Main()
' The path to the certificate.
Dim Certificate As String = "Certificate.cer"
' Load the certificate into an X509Certificate object.
Dim cert As New X509Certificate(Certificate)
' Get the value.
Dim resultsTrue As String = cert.ToString(True)
' Display the value to the console.
Console.WriteLine(resultsTrue)
' Get the value.
Dim resultsFalse As String = cert.ToString(False)
' Display the value to the console.
Console.WriteLine(resultsFalse)
End Sub
End Module
備註
ASN.1 DER 是這個類別唯一支援的憑證格式。
在大部分情況下，您應該改用 類別 X509Certificate2 。
重要
從 .NET Framework 4.6 開始，此類型會實作 IDisposable 介面。 當您完成使用型別時，您應該直接或間接處置它。 若要直接處置型別，請呼叫其 try/catch 區塊中的 Dispose 方法。 若要間接處置它，請使用語言建構函式，例如 using (在 C# 中) 或 Using (在 Visual Basic 中)。 如需詳細資訊，請參閱 IDisposable 介面文章中的＜使用實作 IDisposable 的物件＞一節。
對於以 .NET Framework 4.5.2 和更早版本為目標的應用程式，類別X509Certificate不會實作 IDisposable 介面，因此沒有 Dispose 方法。
建構函式
屬性
| Handle |
取得 Unmanaged |
| Issuer |
取得核發 X.509v3 憑證的憑證授權單位名稱。 |
| SerialNumberBytes |
取得憑證序號的 big-endian 表示法。 |
| Subject |
取得憑證的主旨辨別名稱。 |
方法
明確介面實作
| IDeserializationCallback.OnDeserialization(Object) |
實作 ISerializable 介面並在還原序列化完成時，由還原序列化事件回呼。 |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
取得重新建立目前 X509Certificate 物件的執行個體所需之全部資料的序列化資訊。 |
