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 ISerializable[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
interface IDeserializationCallback
interface ISerializable
interface IDisposablePublic 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 |
获取非托管 |
| Issuer |
获取颁发此 X.509v3 证书的证书颁发机构的名称。 |
| Subject |
获取证书的主题可分辨名称。 |
方法
显式接口实现
| IDeserializationCallback.OnDeserialization(Object) |
实现 ISerializable 接口，并在完成反序列化后由反序列化事件回调。 |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
获取序列化信息，其中包含重新创建当前 X509Certificate 对象的实例所需的所有数据。 |