X509Certificate2Collection.Add メソッド

.NET Framework クラス ライブラリ リファレンス

X509Certificate2Collection.Add メソッド (X509Certificate2)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

X509Certificate2Collection の末尾にオブジェクトを追加します。

名前空間: System.Security.Cryptography.X509Certificates
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Add ( _
    certificate As X509Certificate2 _
) As Integer

Visual Basic (使用法)

Dim instance As X509Certificate2Collection
Dim certificate As X509Certificate2
Dim returnValue As Integer

returnValue = instance.Add(certificate)

C#

public int Add (
    X509Certificate2 certificate
)

C++

public:
int Add (
    X509Certificate2^ certificate
)

J#

public int Add (
    X509Certificate2 certificate
)

JScript

public function Add (
    certificate : X509Certificate2
) : int

パラメータ

certificate

X509Certificate2 オブジェクトとして表される X.509 証明書。

戻り値
certificate が追加された位置の X509Certificate2Collection インデックス。

例外

例外の種類	条件
ArgumentNullException	certificate が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、X509Certificate2 オブジェクトをコレクションに追加し、証明書のインデックス位置を返します。

使用例

X.509 証明書ストアを開いて証明書を追加および削除し、証明書ストアを閉じるコード例を次に示します。ローカル ストアに追加またはローカル ストアから削除する証明書が 3 つあると仮定しています。

C#

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

public class X509store2
{
    public static void Main
 (string[] args)
    {
        //Create new X509 store called teststore from the local certificate
 store.
        X509Store store = new X509Store ("teststore",
 StoreLocation.CurrentUser);
        store.Open (OpenFlags.ReadWrite);
        X509Certificate2 certificate = new X509Certificate2 ();

        //Create certificates from certificate files.
        //You must put in a valid path to three certificates in the
 following constructors.
        X509Certificate2 certificate1 = new X509Certificate2 ("c:\\mycerts\\*****.cer");
        X509Certificate2 certificate2 = new X509Certificate2 ("c:\\mycerts\\*****.cer");
        X509Certificate2 certificate5 = new X509Certificate2 ("c:\\mycerts\\*****.cer");

        //Create a collection and add two of the certificates.
        X509Certificate2Collection collection = new X509Certificate2Collection
 ();
        collection.Add (certificate2);
        collection.Add (certificate5);

        //Add certificates to the store.
        store.Add (certificate1);
        store.AddRange (collection);

        X509Certificate2Collection storecollection = (X509Certificate2Collection)store.Certificates;
        Console.WriteLine ("Store name: {0}", store.Name);
        Console.WriteLine ("Store location: {0}", store.Location);
        foreach (X509Certificate2 x509 in storecollection)
        {
            Console.WriteLine("certificate name: {0}",x509.Subject);
        }

        //Remove a certificate.
        store.Remove (certificate1);
        X509Certificate2Collection storecollection2 = (X509Certificate2Collection)store.Certificates;
        Console.WriteLine ("{1}Store name: {0}", store.Name, Environment.NewLine);
        foreach (X509Certificate2 x509 in storecollection2)
        {
            Console.WriteLine ("certificate name: {0}", x509.Subject);
        }

        //Remove a range of certificates.
        store.RemoveRange (collection);
        X509Certificate2Collection storecollection3 = (X509Certificate2Collection)store.Certificates;
        Console.WriteLine ("{1}Store name: {0}", store.Name, Environment.NewLine);
        if (storecollection3.Count == 0)
        {
            Console.WriteLine ("Store contains no certificates.");
        }
        else
        {
            foreach (X509Certificate2 x509 in
 storecollection3)
            {
                Console.WriteLine ("certificate name: {0}", x509.Subject);
            }
        }

        //Close the store.
        store.Close ();
    }    
}

C++

#using <System.dll>
#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Cryptography::X509Certificates;
using namespace System::IO;
int main()
{
   
   //Create new X509 store called teststore from the local certificate
 store.
   X509Store ^ store = gcnew X509Store( "teststore",StoreLocation::CurrentUser
 );
   store->Open( OpenFlags::ReadWrite );
   X509Certificate2 ^ certificate = gcnew X509Certificate2;
   
   //Create certificates from certificate files.
   //You must put in a valid path to three certificates in the following
 constructors.
   X509Certificate2 ^ certificate1 = gcnew X509Certificate2( "c:\\mycerts\\*****.cer"
 );
   X509Certificate2 ^ certificate2 = gcnew X509Certificate2( "c:\\mycerts\\*****.cer"
 );
   X509Certificate2 ^ certificate5 = gcnew X509Certificate2( "c:\\mycerts\\*****.cer"
 );
   
   //Create a collection and add two of the certificates.
   X509Certificate2Collection ^ collection = gcnew X509Certificate2Collection;
   collection->Add( certificate2 );
   collection->Add( certificate5 );
   
   //Add certificates to the store.
   store->Add( certificate1 );
   store->AddRange( collection );
   X509Certificate2Collection ^ storecollection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
   Console::WriteLine( "Store name: {0}", store->Name );
   Console::WriteLine( "Store location: {0}", store->Location );
   System::Collections::IEnumerator^ myEnum = storecollection->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
      Console::WriteLine( "certificate name: {0}", x509->Subject );
   }

   
   //Remove a certificate.
   store->Remove( certificate1 );
   X509Certificate2Collection ^ storecollection2 = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
   Console::WriteLine( "{1}Store name: {0}", store->Name, Environment::NewLine
 );
   System::Collections::IEnumerator^ myEnum1 = storecollection2->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum1->Current);
      Console::WriteLine( "certificate name: {0}", x509->Subject );
   }

   
   //Remove a range of certificates.
   store->RemoveRange( collection );
   X509Certificate2Collection ^ storecollection3 = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
   Console::WriteLine( "{1}Store name: {0}", store->Name, Environment::NewLine
 );
   if ( storecollection3->Count == 0 )
   {
      Console::WriteLine( "Store contains no certificates." );
   }
   else
   {
      System::Collections::IEnumerator^ myEnum2 = storecollection3->GetEnumerator();
      while ( myEnum2->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum2->Current);
         Console::WriteLine( "certificate name: {0}", x509->Subject
 );
      }
   }

   
   //Close the store.
   store->Close();
}

J#

import System.*;
import System.Security.Cryptography.*;
import System.Security.Cryptography.X509Certificates.*;
import System.IO.*;

public class X509store2
{
    public static void main(String[]
 args)
    {
        // Create new X509 store called teststore from the local 
        // certificate store.
        X509Store store = new X509Store("teststore",
 StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadWrite);
        X509Certificate2 certificate = new X509Certificate2();
        //Create certificates from certificate files.
        // You must put in a valid path to three certificates in the
 following 
        // constructors.
        X509Certificate2 certificate1 = new X509Certificate2(
            "c:\\mycerts\\*****.cer");
        X509Certificate2 certificate2 = new X509Certificate2(
            "c:\\mycerts\\*****.cer");
        X509Certificate2 certificate5 = new X509Certificate2(
            "c:\\mycerts\\*****.cer");
        //Create a collection and add two of the certificates.
        X509Certificate2Collection collection = 
            new X509Certificate2Collection();
        collection.Add(certificate2);
        collection.Add(certificate5);
        //Add certificates to the store.
        store.Add(certificate1);
        store.AddRange(collection);

        X509Certificate2Collection storecollection = 
            (X509Certificate2Collection)store.get_Certificates();
        Console.WriteLine("Store name: {0}", store.get_Name());
        Console.WriteLine("Store location: {0}", store.get_Location());
        for (int iCtr = 0; iCtr < storecollection.get_Count();
 iCtr++) {
            X509Certificate2 x509 = storecollection.get_Item(iCtr);
            Console.WriteLine("certificate name: {0}", x509.get_Subject());
        }
        //Remove a certificate.
        store.Remove(certificate1);
        X509Certificate2Collection storecollection2 = 
            (X509Certificate2Collection)store.get_Certificates();
        Console.WriteLine("{1}Store name: {0}", store.get_Name(),
            Environment.get_NewLine());
        for (int iCtr = 0; iCtr < storecollection2.get_Count();
 iCtr++) {
            X509Certificate2 x509 = storecollection2.get_Item(iCtr);
            Console.WriteLine("certificate name: {0}", x509.get_Subject());
        }
        //Remove a range of certificates.
        store.RemoveRange(collection);
        X509Certificate2Collection storecollection3 =
            (X509Certificate2Collection)store.get_Certificates();
        Console.WriteLine("{1}Store name: {0}", store.get_Name(), 
            Environment.get_NewLine());
        if (storecollection3.get_Count() == 0) {
            Console.WriteLine("Store contains no certificates.");
        }
        else {
            for (int iCtr = 0; iCtr < storecollection3.get_Count();
 iCtr++) {
                X509Certificate2 x509 = storecollection3.get_Item(iCtr);
                Console.WriteLine("certificate name: {0}", x509.get_Subject());
            }
        }
        //Close the store.
        store.Close();
    } //main
} //X509store2

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
X509Certificate2Collection クラス
X509Certificate2Collection メンバ
System.Security.Cryptography.X509Certificates 名前空間

X509Certificate2Collection.Add メソッド

X509Certificate2Collection オブジェクトの末尾にオブジェクトを追加します。
オーバーロードの一覧

名前	説明
X509Certificate2Collection.Add (X509Certificate)	指定した値を持つ X509Certificate を現在の X509CertificateCollection に追加します。
X509Certificate2Collection.Add (X509Certificate2)	X509Certificate2Collection の末尾にオブジェクトを追加します。

参照

関連項目

X509Certificate2Collection クラス
X509Certificate2Collection メンバ
System.Security.Cryptography.X509Certificates 名前空間