X509Certificate X509Certificate X509Certificate X509Certificate Class

定義

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

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type X509Certificate = class
    interface IDeserializationCallback
    interface ISerializable
    interface IDisposable
Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable
継承
X509CertificateX509CertificateX509CertificateX509Certificate
派生
属性
実装

次の例では、ファイルから x.509 証明書を読み込み、 ToStringメソッドを呼び出して、結果をコンソールに表示します。The following example loads an X.509 certificate from a file, calls the ToString method, and displays the results to the console.

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 は、このクラスでサポートされている唯一の証明書形式です。ASN.1 DER is the only certificate format supported by this class.

ほとんどのシナリオでは、代わりにX509Certificate2クラスを使用する必要があります。For most scenarios, you should use the X509Certificate2 class instead.

重要

以降では.NET Framework 4.6.NET Framework 4.6、この型はIDisposableインターフェイスを実装します。Starting with the .NET Framework 4.6.NET Framework 4.6, this type implements the IDisposable interface. 型の使用が完了したら、直接的または間接的に型を破棄する必要があります。When you have finished using the type, you should dispose of it either directly or indirectly. 直接的に型を破棄するには、try / catch ブロック内で Dispose メソッドを呼び出します。To dispose of the type directly, call its Dispose method in a try/catch block. 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

以前の.NET Framework 4.5.2.NET Framework 4.5.2バージョンを対象とするアプリの場合X509CertificateIDisposableクラスはインターフェイスを実装しないため、 Disposeメソッドはありません。For apps that target the .NET Framework 4.5.2.NET Framework 4.5.2 and earlier versions, the X509Certificate class does not implement the IDisposable interface and therefore does not have a Dispose method.

コンストラクター

X509Certificate() X509Certificate() X509Certificate() X509Certificate()

X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class.

X509Certificate(Byte[]) X509Certificate(Byte[]) X509Certificate(Byte[]) X509Certificate(Byte[])

X.509v3 証明書を表すバイトのシーケンスから定義された X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

X509Certificate(Byte[], SecureString) X509Certificate(Byte[], SecureString) X509Certificate(Byte[], SecureString) X509Certificate(Byte[], SecureString)

バイト配列とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags) X509Certificate(Byte[], SecureString, X509KeyStorageFlags) X509Certificate(Byte[], SecureString, X509KeyStorageFlags) X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

バイト配列、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(Byte[], String) X509Certificate(Byte[], String) X509Certificate(Byte[], String) X509Certificate(Byte[], String)

バイト配列とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate(Byte[], String, X509KeyStorageFlags) X509Certificate(Byte[], String, X509KeyStorageFlags) X509Certificate(Byte[], String, X509KeyStorageFlags) X509Certificate(Byte[], String, X509KeyStorageFlags)

バイト配列、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(IntPtr) X509Certificate(IntPtr) X509Certificate(IntPtr) X509Certificate(IntPtr)

アンマネージ PCCERT_CONTEXT 構造体を識別するハンドルを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

X509Certificate(SerializationInfo, StreamingContext) X509Certificate(SerializationInfo, StreamingContext) X509Certificate(SerializationInfo, StreamingContext) X509Certificate(SerializationInfo, StreamingContext)

X509Certificate オブジェクトと SerializationInfo 構造体を使用して、StreamingContext クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

X509Certificate(String) X509Certificate(String) X509Certificate(String) X509Certificate(String)

PKCS7 で署名されたファイルの名前を使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

X509Certificate(String, SecureString) X509Certificate(String, SecureString) X509Certificate(String, SecureString) X509Certificate(String, SecureString)

証明書ファイル名とパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a certificate file name and a password.

X509Certificate(String, SecureString, X509KeyStorageFlags) X509Certificate(String, SecureString, X509KeyStorageFlags) X509Certificate(String, SecureString, X509KeyStorageFlags) X509Certificate(String, SecureString, X509KeyStorageFlags)

証明書ファイル名、パスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

X509Certificate(String, String) X509Certificate(String, String) X509Certificate(String, String) X509Certificate(String, String)

PKCS7 で署名されたファイルの名前と証明書にアクセスするためのパスワードを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

X509Certificate(String, String, X509KeyStorageFlags) X509Certificate(String, String, X509KeyStorageFlags) X509Certificate(String, String, X509KeyStorageFlags) X509Certificate(String, String, X509KeyStorageFlags)

PKCS7 で署名されたファイルの名前、証明書にアクセスするためのパスワード、およびキー格納フラグを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

X509Certificate(X509Certificate) X509Certificate(X509Certificate) X509Certificate(X509Certificate) X509Certificate(X509Certificate)

別の X509Certificate クラスを使用して、X509Certificate クラスの新しいインスタンスを初期化します。Initializes a new instance of the X509Certificate class using another X509Certificate class.

プロパティ

Handle Handle Handle Handle

アンマネージ PCCERT_CONTEXT 構造体で指定された Microsoft Cryptographic API 証明書コンテキストを識別するハンドルを取得します。Gets a handle to a Microsoft Cryptographic API certificate context described by an unmanaged PCCERT_CONTEXT structure.

Issuer Issuer Issuer Issuer

X.509v3 証明書を発行した証明機関の名前を取得します。Gets the name of the certificate authority that issued the X.509v3 certificate.

Subject Subject Subject Subject

証明書からサブジェクトの識別名を取得します。Gets the subject distinguished name from the certificate.

メソッド

CreateFromCertFile(String) CreateFromCertFile(String) CreateFromCertFile(String) CreateFromCertFile(String)

PKCS7 で署名された指定のファイルから X.509v3 証明書を作成します。Creates an X.509v3 certificate from the specified PKCS7 signed file.

CreateFromSignedFile(String) CreateFromSignedFile(String) CreateFromSignedFile(String) CreateFromSignedFile(String)

指定した署名済みファイルから X.509v3 証明書を作成します。Creates an X.509v3 certificate from the specified signed file.

Dispose() Dispose() Dispose() Dispose()

現在の X509Certificate オブジェクトによって使用されているすべてのリソースを解放します。Releases all resources used by the current X509Certificate object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

この X509Certificate によって使用されているすべてのアンマネージド リソースを解放します。さらにマネージド リソースを解放することもできます。Releases all of the unmanaged resources used by this X509Certificate and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

2 つの X509Certificate オブジェクトが等しいかどうかを比較します。Compares two X509Certificate objects for equality.

Equals(X509Certificate) Equals(X509Certificate) Equals(X509Certificate) Equals(X509Certificate)

2 つの X509Certificate オブジェクトが等しいかどうかを比較します。Compares two X509Certificate objects for equality.

Export(X509ContentType) Export(X509ContentType) Export(X509ContentType) Export(X509ContentType)

いずれかの X509Certificate 値で記述する形式で、現在の X509ContentType オブジェクトをバイト配列にエクスポートします。Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Export(X509ContentType, SecureString) Export(X509ContentType, SecureString) Export(X509ContentType, SecureString) Export(X509ContentType, SecureString)

形式とパスワードを指定して、現在の X509Certificate オブジェクトをバイト配列にエクスポートします。Exports the current X509Certificate object to a byte array using the specified format and a password.

Export(X509ContentType, String) Export(X509ContentType, String) Export(X509ContentType, String) Export(X509ContentType, String)

指定したパスワードを使用し、いずれかの X509Certificate 値で記述する形式で、現在の X509ContentType オブジェクトをバイト配列にエクスポートします。Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values, and using the specified password.

FormatDate(DateTime) FormatDate(DateTime) FormatDate(DateTime) FormatDate(DateTime)

指定した日付と時刻を文字列に変換します。Converts the specified date and time to a string.

GetCertHash() GetCertHash() GetCertHash() GetCertHash()

X.509v3 証明書のハッシュ値をバイト配列として返します。Returns the hash value for the X.509v3 certificate as an array of bytes.

GetCertHash(HashAlgorithmName) GetCertHash(HashAlgorithmName) GetCertHash(HashAlgorithmName) GetCertHash(HashAlgorithmName)

指定された暗号ハッシュ アルゴリズムを使用して計算される X.509v3 証明書のハッシュ値を返します。Returns the hash value for the X.509v3 certificate that is computed by using the specified cryptographic hash algorithm.

GetCertHashString() GetCertHashString() GetCertHashString() GetCertHashString()

X.509v3 証明書の SHA1 ハッシュ値を 16 進数文字列として返します。Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.

GetCertHashString(HashAlgorithmName) GetCertHashString(HashAlgorithmName) GetCertHashString(HashAlgorithmName) GetCertHashString(HashAlgorithmName)

指定された暗号ハッシュ アルゴリズムを使用して計算される X.509v3 証明書のハッシュ値を含む 16 進数文字列を返します。Returns a hexadecimal string containing the hash value for the X.509v3 certificate computed using the specified cryptographic hash algorithm.

GetEffectiveDateString() GetEffectiveDateString() GetEffectiveDateString() GetEffectiveDateString()

この X.509v3 証明書の発効日を返します。Returns the effective date of this X.509v3 certificate.

GetExpirationDateString() GetExpirationDateString() GetExpirationDateString() GetExpirationDateString()

この X.509v3 証明書の失効日を返します。Returns the expiration date of this X.509v3 certificate.

GetFormat() GetFormat() GetFormat() GetFormat()

この X.509v3 証明書の形式の名前を返します。Returns the name of the format of this X.509v3 certificate.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

X.509v3 証明書の整数形式のハッシュ コードを返します。Returns the hash code for the X.509v3 certificate as an integer.

GetIssuerName() GetIssuerName() GetIssuerName() GetIssuerName()

X.509v3 証明書を発行した証明機関の名前を返します。Returns the name of the certification authority that issued the X.509v3 certificate.

GetKeyAlgorithm() GetKeyAlgorithm() GetKeyAlgorithm() GetKeyAlgorithm()

この X.509v3 証明書の文字列形式のキー アルゴリズム情報を返します。Returns the key algorithm information for this X.509v3 certificate as a string.

GetKeyAlgorithmParameters() GetKeyAlgorithmParameters() GetKeyAlgorithmParameters() GetKeyAlgorithmParameters()

X.509v3 証明書のバイト配列形式のキー アルゴリズム パラメーターを返します。Returns the key algorithm parameters for the X.509v3 certificate as an array of bytes.

GetKeyAlgorithmParametersString() GetKeyAlgorithmParametersString() GetKeyAlgorithmParametersString() GetKeyAlgorithmParametersString()

この X.509v3 証明書の 16 進数文字列形式のキー アルゴリズム パラメーターを返します。Returns the key algorithm parameters for the X.509v3 certificate as a hexadecimal string.

GetName() GetName() GetName() GetName()

証明書の発行先であるプリンシパルの名前を返します。Returns the name of the principal to which the certificate was issued.

GetPublicKey() GetPublicKey() GetPublicKey() GetPublicKey()

X.509v3 証明書のバイト配列形式の公開キーを返します。Returns the public key for the X.509v3 certificate as an array of bytes.

GetPublicKeyString() GetPublicKeyString() GetPublicKeyString() GetPublicKeyString()

X.509v3 証明書の 16 進数文字列形式の公開キーを返します。Returns the public key for the X.509v3 certificate as a hexadecimal string.

GetRawCertData() GetRawCertData() GetRawCertData() GetRawCertData()

X.509v3 証明書全体のバイト配列形式の生データを返します。Returns the raw data for the entire X.509v3 certificate as an array of bytes.

GetRawCertDataString() GetRawCertDataString() GetRawCertDataString() GetRawCertDataString()

X.509v3 証明書全体の 16 進数文字列形式の生データを返します。Returns the raw data for the entire X.509v3 certificate as a hexadecimal string.

GetSerialNumber() GetSerialNumber() GetSerialNumber() GetSerialNumber()

X.509v3 証明書のバイト配列形式のシリアル番号をリトル エンディアン順で返します。Returns the serial number of the X.509v3 certificate as an array of bytes in little-endian order.

GetSerialNumberString() GetSerialNumberString() GetSerialNumberString() GetSerialNumberString()

X.509v3 証明書のリトル エンディアン 16 進数文字列形式のシリアル番号を返します。Returns the serial number of the X.509v3 certificate as a little-endian hexadecimal string .

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Import(Byte[]) Import(Byte[]) Import(Byte[]) Import(Byte[])

バイト配列のデータを使用して、X509Certificate オブジェクトを設定します。Populates the X509Certificate object with data from a byte array.

Import(Byte[], SecureString, X509KeyStorageFlags) Import(Byte[], SecureString, X509KeyStorageFlags) Import(Byte[], SecureString, X509KeyStorageFlags) Import(Byte[], SecureString, X509KeyStorageFlags)

バイト配列のデータ、パスワード、およびキー格納フラグを使用して、X509Certificate オブジェクトを設定します。Populates an X509Certificate object using data from a byte array, a password, and a key storage flag.

Import(Byte[], String, X509KeyStorageFlags) Import(Byte[], String, X509KeyStorageFlags) Import(Byte[], String, X509KeyStorageFlags) Import(Byte[], String, X509KeyStorageFlags)

バイト配列のデータ、パスワード、および秘密キーのインポート方法を決定するフラグを使用して、X509Certificate オブジェクトを設定します。Populates the X509Certificate object using data from a byte array, a password, and flags for determining how the private key is imported.

Import(String) Import(String) Import(String) Import(String)

証明書ファイルからの情報を使用して、X509Certificate オブジェクトを設定します。Populates the X509Certificate object with information from a certificate file.

Import(String, SecureString, X509KeyStorageFlags) Import(String, SecureString, X509KeyStorageFlags) Import(String, SecureString, X509KeyStorageFlags) Import(String, SecureString, X509KeyStorageFlags)

証明書ファイルの情報、パスワード、およびキー格納フラグを指定して、X509Certificate オブジェクトを設定します。Populates an X509Certificate object with information from a certificate file, a password, and a key storage flag.

Import(String, String, X509KeyStorageFlags) Import(String, String, X509KeyStorageFlags) Import(String, String, X509KeyStorageFlags) Import(String, String, X509KeyStorageFlags)

証明書ファイルの情報、パスワード、および X509Certificate 値を使用して、X509KeyStorageFlags オブジェクトを設定します。Populates the X509Certificate object with information from a certificate file, a password, and a X509KeyStorageFlags value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Reset() Reset() Reset() Reset()

X509Certificate2 オブジェクトの状態をリセットします。Resets the state of the X509Certificate2 object.

ToString() ToString() ToString() ToString()

現在の X509Certificate オブジェクトの文字列形式を返します。Returns a string representation of the current X509Certificate object.

ToString(Boolean) ToString(Boolean) ToString(Boolean) ToString(Boolean)

補足情報が指定されている場合はその情報を含めて、現在の X509Certificate オブジェクトの文字列形式を返します。Returns a string representation of the current X509Certificate object, with extra information, if specified.

TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32) TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32) TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32) TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

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

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントによってコールバックされます。Implements the ISerializable interface and is called back by the deserialization event when deserialization is complete.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

シリアル化情報と、現在の X509Certificate オブジェクトのインスタンスの再作成に必要なすべてのデータを取得します。Gets serialization information with all the data needed to recreate an instance of the current X509Certificate object.

適用対象