X509Certificate クラス

リファレンス

定義

名前空間:: System.Security.Cryptography.X509Certificates

アセンブリ:: System.Security.Cryptography.X509Certificates.dll

アセンブリ:: System.Security.Cryptography.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: X509Certificate.cs

ソース:: X509Certificate.cs

ソース:: X509Certificate.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

X.509 v.3 証明書を使用するために役立つメソッドを提供します。

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public ref class X509Certificate : IDisposable

public ref class X509Certificate

public ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public 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.ISerializable

type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

type X509Certificate = class
    interface IDisposable

type 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

Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable

Public Class X509Certificate
Implements IDisposable

Public Class X509Certificate

Public Class X509Certificate
Implements IDeserializationCallback, ISerializable

継承: Object
X509Certificate

派生: System.Security.Cryptography.X509Certificates.X509Certificate2

属性: SerializableAttribute ComVisibleAttribute

実装: IDisposable IDeserializationCallback ISerializable

例

次の例では、ファイルから 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。

コンストラクター

X509Certificate()	古い. 古い. X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(Byte[])	古い. X.509v3 証明書を表すバイトのシーケンスから定義された X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(Byte[], SecureString)	古い. バイト配列とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	古い. バイト配列、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(Byte[], String)	古い. バイト配列とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(Byte[], String, X509KeyStorageFlags)	古い. バイト配列、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(IntPtr)	アンマネージ `PCCERT_CONTEXT` 構造体を識別するハンドルを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(SerializationInfo, StreamingContext)	古い. X509Certificate オブジェクトと SerializationInfo 構造体を使用して、StreamingContext クラスの新しいインスタンスを初期化します。
X509Certificate(String)	古い. PKCS7 で署名されたファイルの名前を使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(String, SecureString)	古い. 証明書ファイル名とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(String, SecureString, X509KeyStorageFlags)	古い. 証明書ファイル名、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(String, String)	古い. PKCS7 で署名されたファイルの名前と証明書にアクセスするためのパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(String, String, X509KeyStorageFlags)	古い. PKCS7 で署名されたファイルの名前、証明書にアクセスするためのパスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。
X509Certificate(X509Certificate)	別の X509Certificate クラスを使用して、X509Certificate クラスの新しいインスタンスを初期化します。

プロパティ

Handle	アンマネージ `PCCERT_CONTEXT` 構造体で指定された Microsoft Cryptographic API 証明書コンテキストを識別するハンドルを取得します。
Issuer	X.509v3 証明書を発行した証明機関の名前を取得します。
SerialNumberBytes	証明書のシリアル番号のビッグエンディアン表現を取得します。
Subject	証明書からサブジェクトの識別名を取得します。

メソッド

CreateFromCertFile(String)	古い. PKCS7 で署名された指定のファイルから X.509v3 証明書を作成します。
CreateFromSignedFile(String)	古い. 指定した署名済みファイルから X.509v3 証明書を作成します。
Dispose()	現在の X509Certificate オブジェクトによって使用されているすべてのリソースを解放します。
Dispose(Boolean)	この X509Certificate によって使用されているすべてのアンマネージドリソースを解放します。さらにマネージドリソースを解放することもできます。
Equals(Object)	2 つの X509Certificate オブジェクトが等しいかどうかを比較します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Equals(X509Certificate)	2 つの X509Certificate オブジェクトが等しいかどうかを比較します。
Export(X509ContentType)	いずれかの X509Certificate 値で記述する形式で、現在の X509ContentType オブジェクトをバイト配列にエクスポートします。
Export(X509ContentType, SecureString)	形式とパスワードを指定して、現在の X509Certificate オブジェクトをバイト配列にエクスポートします。
Export(X509ContentType, String)	指定したパスワードを使用し、いずれかの X509Certificate 値で記述する形式で、現在の X509ContentType オブジェクトをバイト配列にエクスポートします。
FormatDate(DateTime)	指定した日付と時刻を文字列に変換します。
GetCertHash()	X.509v3 証明書のハッシュ値をバイト配列として返します。
GetCertHash(HashAlgorithmName)	指定された暗号ハッシュアルゴリズムを使用して計算される X.509v3 証明書のハッシュ値を返します。
GetCertHashString()	X.509v3 証明書の SHA1 ハッシュ値を 16 進数文字列で返します。
GetCertHashString(HashAlgorithmName)	指定された暗号ハッシュアルゴリズムを使用して計算される X.509v3 証明書のハッシュ値を含む 16 進数文字列を返します。
GetEffectiveDateString()	この X.509v3 証明書の発効日を返します。
GetExpirationDateString()	この X.509v3 証明書の失効日を返します。
GetFormat()	この X.509v3 証明書の形式の名前を返します。
GetHashCode()	X.509v3 証明書の整数形式のハッシュコードを返します。
GetIssuerName()	古い. 古い. 古い. X.509v3 証明書を発行した証明機関の名前を返します。
GetKeyAlgorithm()	この X.509v3 証明書のキーアルゴリズム情報を文字列で返します。
GetKeyAlgorithmParameters()	X.509v3 証明書のバイト配列形式のキーアルゴリズムパラメーターを返します。
GetKeyAlgorithmParametersString()	X.509v3 証明書のキーアルゴリズムパラメーターを 16 進数文字列で返します。
GetName()	古い. 古い. 古い. 証明書の発行先であるプリンシパルの名前を返します。
GetPublicKey()	X.509v3 証明書のバイト配列形式の公開キーを返します。
GetPublicKeyString()	X.509v3 証明書の 16 進数文字列形式の公開キーを返します。
GetRawCertData()	X.509v3 証明書全体のバイト配列形式の生データを返します。
GetRawCertDataString()	X.509v3 証明書全体の 16 進数文字列形式の生データを返します。
GetSerialNumber()	X.509v3 証明書のバイト配列形式のシリアル番号をリトルエンディアン順で返します。
GetSerialNumberString()	X.509v3 証明書のリトルエンディアン 16 進数文字列形式のシリアル番号を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Import(Byte[])	古い. 古い. バイト配列のデータを使用して、X509Certificate オブジェクトを設定します。
Import(Byte[], SecureString, X509KeyStorageFlags)	古い. 古い. バイト配列のデータ、パスワード、およびキー格納フラグを使用して、X509Certificate オブジェクトを設定します。
Import(Byte[], String, X509KeyStorageFlags)	古い. 古い. バイト配列のデータ、パスワード、および秘密キーのインポート方法を決定するフラグを使用して、X509Certificate オブジェクトを設定します。
Import(String)	古い. 古い. 証明書ファイルからの情報を使用して、X509Certificate オブジェクトを設定します。
Import(String, SecureString, X509KeyStorageFlags)	古い. 古い. 証明書ファイルの情報、パスワード、およびキー格納フラグを指定して、X509Certificate オブジェクトを設定します。
Import(String, String, X509KeyStorageFlags)	古い. 古い. 証明書ファイルの情報、パスワード、および X509Certificate 値を使用して、X509KeyStorageFlags オブジェクトを設定します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Reset()	X509Certificate2 オブジェクトの状態をリセットします。
ToString()	現在の X509Certificate オブジェクトの文字列形式を返します。
ToString(Boolean)	補足情報が指定されている場合はその情報を含めて、現在の X509Certificate オブジェクトの文字列形式を返します。
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	指定されたハッシュアルゴリズムを使用して、証明書のエンコードされた表現をハッシュすることによって、証明書の "サムプリント" を生成することを試みます。

明示的なインターフェイスの実装

IDeserializationCallback.OnDeserialization(Object)	ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントによってコールバックされます。
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	シリアル化情報と、現在の X509Certificate オブジェクトのインスタンスの再作成に必要なすべてのデータを取得します。

適用対象

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

次の方法で共有