OidEnumerator.Reset メソッド

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

OidEnumerator.Reset メソッド

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

列挙子を初期位置に設定します。

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

Visual Basic (宣言)

Public Sub Reset

Visual Basic (使用法)

Dim instance As OidEnumerator

instance.Reset

C#

public void Reset ()

C++

public:
virtual void Reset () sealed

J#

public final void Reset ()

JScript

public final function Reset ()

例外

例外の種類	条件
InvalidOperationException	列挙子が作成された後に、コレクションが変更されました。

解説

列挙子の初期位置は、OidCollection オブジェクトの最初の要素の前です。コレクションが変更されない限り、列挙子は有効なままです。要素の追加、変更、削除などの変更がコレクションに対して実行されると、列挙子は無効状態になり、次に Reset メソッドを呼び出すと InvalidOperationException がスローされます。

使用例

OidEnumerator クラスを使用するコード例を次に示します。

Visual Basic

Imports System
Imports System.Security.Cryptography


Public Class OidSample
   Shared msg As String
   Public Shared Sub Main()
      ' Assign values to strings.
      Dim Value1 As String
 = "1.2.840.113549.1.1.1"
      Dim Name1 As String
 = "3DES"
      Dim Value2 As String
 = "1.3.6.1.4.1.311.20.2"
      Dim InvalidName As String
 = "This name is not a valid name"
      Dim InvalidValue As String
 = "1.1.1.1.1.1.1.1"
      
      ' Create new Oid objects using the specified values.
      ' Note that the corresponding Value or Friendly Name property
 is automatically added to the object.
      Dim o1 As New Oid(Value1)
      Dim o2 As New Oid(Name1)
      
      ' Create a new Oid object using the specified Value and Friendly
 Name properties.
      ' Note that the two are not compared to determine if the Value
 is associated 
      '  with the Friendly Name.
      Dim o3 As New Oid(Value2,
 InvalidName)
      
      'Create a new Oid object using the specified Value. Note that
 if the value
      '  is invalid or not known, no value is assigned to the Friendly
 Name property.
      Dim o4 As New Oid(InvalidValue)
      
      'Write out the property information of the Oid objects.
    msg = "Oid1: Automatically assigned Friendly Name: "
 & o1.FriendlyName & ", " & o1.Value
    MsgBox(msg)
      'Console.WriteLine("Oid1: Automatically assigned Friendly
 Name: {0}, {1}", o1.FriendlyName, o1.Value)


      'Console.WriteLine("Oid2: Automatically assigned Value: {0},
 {1}", o2.FriendlyName, o2.Value)
    msg = "Oid2: Automatically assigned Value: " &
 o2.FriendlyName & ", " & o2.Value
    MsgBox(msg)


      'Console.WriteLine("Oid3: Name and Value not compared: {0},
 {1}", o3.FriendlyName, o3.Value)
    msg = "Oid3: Name and Value not compared: " &
 o3.FriendlyName & ", " & o3.Value
    MsgBox(msg)



     ' Console.WriteLine("Oid4: Invalid Value used: {0}, {1} {2}",
 o4.FriendlyName, o4.Value, Environment.NewLine)
    msg = "Oid4: Invalid Value used: " & o4.FriendlyName
 & ", " & o4.Value
    MsgBox(msg)
 

     
      'Create an Oid collection and add several Oid objects.
      Dim oc As New OidCollection()
      oc.Add(o1)
      oc.Add(o2)
      oc.Add(o3)
     ' Console.WriteLine("Number of Oids in the collection: {0}",
 oc.Count)
      ' Console.WriteLine("Is synchronized: {0} {1}", oc.IsSynchronized,
 Environment.NewLine)

    msg = "Number of Oids in the collection: " &
 oc.Count
    MsgBox(msg)
    msg = "Is synchronized: " & oc.IsSynchronized
    MsgBox(msg)

      
      'Create an enumerator for moving through the collection.
      Dim oe As OidEnumerator = oc.GetEnumerator()
      'You must execute a MoveNext() to get to the first item in the
 collection.
      oe.MoveNext()
      ' Write out Oids in the collection.
      'Console.WriteLine("First Oid in collection: {0},{1}",
 oe.Current.FriendlyName, oe.Current.Value)
    msg = "First Oid in collection: " & oe.Current.FriendlyName
 & ", " & oe.Current.Value
    MsgBox(msg)

      oe.MoveNext()
     ' Console.WriteLine("Second Oid in collection: {0},{1}",
 oe.Current.FriendlyName, oe.Current.Value)
    msg = "Second Oid in collection: " & oe.Current.FriendlyName
 & ", " & oe.Current.Value
    MsgBox(msg)

      'Return index in the collection to the beginning.
      oe.Reset()
   End Sub 'Main
End Class 'OidSample

C#

using System;
using System.Security.Cryptography;
public class OidSample
{
    public static void Main()
    {
        // Assign values to strings.
        string Value1 = "1.2.840.113549.1.1.1";
        string Name1 = "3DES";
        string Value2 = "1.3.6.1.4.1.311.20.2";
        string InvalidName = "This name is not a valid name";
        string InvalidValue = "1.1.1.1.1.1.1.1";

        // Create new Oid objects using the specified values.
        // Note that the corresponding Value or Friendly Name property
 is automatically added to the object.
        Oid o1 = new Oid(Value1);
        Oid o2 = new Oid(Name1);

        // Create a new Oid object using the specified Value and Friendly
 Name properties.
        // Note that the two are not compared to determine if the Value
 is associated 
        //  with the Friendly Name.
        Oid o3 = new Oid(Value2, InvalidName);

        //Create a new Oid object using the specified Value. Note that
 if the value
        //  is invalid or not known, no value is assigned to the Friendly
 Name property.
        Oid o4 = new Oid(InvalidValue);

        //Write out the property information of the Oid objects.
        Console.WriteLine("Oid1: Automatically assigned Friendly Name: {0},
 {1}", o1.FriendlyName, o1.Value);
        Console.WriteLine("Oid2: Automatically assigned Value: {0}, {1}",
 o2.FriendlyName, o2.Value);
        Console.WriteLine("Oid3: Name and Value not compared: {0}, {1}",
 o3.FriendlyName, o3.Value);
        Console.WriteLine("Oid4: Invalid Value used: {0}, {1} {2}", o4.FriendlyName,
 o4.Value, Environment.NewLine);

        //Create an Oid collection and add several Oid objects.
        OidCollection oc = new OidCollection();
        oc.Add(o1);
        oc.Add(o2);
        oc.Add(o3);
        Console.WriteLine("Number of Oids in the collection:
 {0}", oc.Count);
        Console.WriteLine("Is synchronized: {0} {1}", oc.IsSynchronized,
 Environment.NewLine);

        //Create an enumerator for moving through the collection.
        OidEnumerator oe = oc.GetEnumerator();
        //You must execute a MoveNext() to get to the first item in
 the collection.
        oe.MoveNext();
        // Write out Oids in the collection.
        Console.WriteLine("First Oid in collection: {0},{1}",
 oe.Current.FriendlyName,oe.Current.Value);
        oe.MoveNext();
        Console.WriteLine("Second Oid in collection: {0}
,{1}",
 oe.Current.FriendlyName, oe.Current.Value);
        //Return index in the collection to the beginning.
        oe.Reset();
    }
}

C++

#using <system.dll>

using namespace System;
using namespace System::Security::Cryptography;
int main()
{
   
   // Assign values to strings.
   String^ Value1 = "1.2.840.113549.1.1.1";
   String^ Name1 = "3DES";
   String^ Value2 = "1.3.6.1.4.1.311.20.2";
   String^ InvalidName = "This name is not a valid name";
   String^ InvalidValue = "1.1.1.1.1.1.1.1";
   
   // Create new Oid objects using the specified values.
   // Note that the corresponding Value or Friendly Name property is
 automatically added to the object.
   Oid ^ o1 = gcnew Oid( Value1 );
   Oid ^ o2 = gcnew Oid( Name1 );
   
   // Create a new Oid object using the specified Value and Friendly
 Name properties.
   // Note that the two are not compared to determine if the Value is
 associated 
   //  with the Friendly Name.
   Oid ^ o3 = gcnew Oid( Value2,InvalidName );
   
   //Create a new Oid object using the specified Value. Note that if
 the value
   //  is invalid or not known, no value is assigned to the Friendly
 Name property.
   Oid ^ o4 = gcnew Oid( InvalidValue );
   
   //Write out the property information of the Oid objects.
   Console::WriteLine( "Oid1: Automatically assigned Friendly Name: {0}, {1}",
 o1->FriendlyName, o1->Value );
   Console::WriteLine( "Oid2: Automatically assigned Value: {0}, {1}",
 o2->FriendlyName, o2->Value );
   Console::WriteLine( "Oid3: Name and Value not compared: {0}, {1}", o3->FriendlyName,
 o3->Value );
   Console::WriteLine( "Oid4: Invalid Value used: {0}, {1} {2}", o4->FriendlyName,
 o4->Value, Environment::NewLine );
   
   //Create an Oid collection and add several Oid objects.
   OidCollection ^ oc = gcnew OidCollection;
   oc->Add( o1 );
   oc->Add( o2 );
   oc->Add( o3 );
   Console::WriteLine( "Number of Oids in the collection:
 {0}", oc->Count );
   Console::WriteLine( "Is synchronized: {0} {1}", oc->IsSynchronized,
 Environment::NewLine );
   
   //Create an enumerator for moving through the collection.
   OidEnumerator ^ oe = oc->GetEnumerator();
   
   //You must execute a MoveNext() to get to the first item in the collection.
   oe->MoveNext();
   
   // Write out Oids in the collection.
   Console::WriteLine( "First Oid in collection: {0},{1}",
 oe->Current->FriendlyName, oe->Current->Value );
   oe->MoveNext();
   Console::WriteLine( "Second Oid in collection: {0},{1}",
 oe->Current->FriendlyName, oe->Current->Value );
   
   //Return index in the collection to the beginning.
   oe->Reset();
}

J#

import System.*;
import System.Security.Cryptography.*;

public class OidSample
{
    public static void main(String
 args[])
    {
        // Assign values to strings.
        String value1 = "1.2.840.113549.1.1.1";
        String name1 = "3DES";
        String value2 = "1.3.6.1.4.1.311.20.2";
        String invalidName = "This name is not a valid name";
        String invalidValue = "1.1.1.1.1.1.1.1";
        // Create new Oid objects using the specified values.
        // Note that the corresponding Value or Friendly Name property
 
        // is automatically added to the object.
        Oid o1 = new Oid(value1);
        Oid o2 = new Oid(name1);
        // Create a new Oid object using the specified Value and Friendly
 
        // Name properties.
        // Note that the two are not compared to determine if the Value
 is 
        // associated with the Friendly Name.
        Oid o3 = new Oid(value2, invalidName);
        // Create a new Oid object using the specified Value. Note that
 if the
        // value is invalid or not known, no value is assigned to the
 Friendly 
        // Name property.
        Oid o4 = new Oid(invalidValue);
        //Write out the property information of the Oid objects.
        Console.WriteLine("Oid1: Automatically assigned Friendly Name: {0},
 {1}",
            o1.get_FriendlyName(), o1.get_Value());
        Console.WriteLine("Oid2: Automatically assigned Value: {0}, {1}",
 
            o2.get_FriendlyName(), o2.get_Value());
        Console.WriteLine("Oid3: Name and Value not compared: {0}, {1}",
 
            o3.get_FriendlyName(), o3.get_Value());
        Console.WriteLine("Oid4: Invalid Value used: {0}, {1} {2}", 
            o4.get_FriendlyName(), o4.get_Value(), Environment.get_NewLine());
        //Create an Oid collection and add several Oid objects.
        OidCollection oc = new OidCollection();
        oc.Add(o1);
        oc.Add(o2);
        oc.Add(o3);
        Console.WriteLine("Number of Oids in the collection:
 {0}", 
            System.Convert.ToString(oc.get_Count()));
        Console.WriteLine("Is synchronized: {0} {1}", 
            System.Convert.ToString(oc.get_IsSynchronized()), 
            Environment.get_NewLine());
        //Create an enumerator for moving through the collection.
        OidEnumerator oe = oc.GetEnumerator();
        //You must execute a MoveNext() to get to the first item in
 the
        //collection.
        oe.MoveNext();
        // Write out Oids in the collection.
        Console.WriteLine("First Oid in collection: {0},{1}",
 
            oe.get_Current().get_FriendlyName(), 
            oe.get_Current().get_Value());
        oe.MoveNext();
        Console.WriteLine("Second Oid in collection: {0}
,{1}",
            oe.get_Current().get_FriendlyName(), oe.get_Current().get_Value());
        //Return index in the collection to the beginning.
        oe.Reset();
    } //main
} //OidSample

プラットフォーム

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

参照

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