Oid Klasa

Definicja

Reprezentuje identyfikator obiektu kryptograficznego. Klasa ta nie może być dziedziczona.

C#
public sealed class Oid
Dziedziczenie
Oid

Przykłady

W poniższym przykładzie kodu pokazano, jak używać Oid klasy.

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();
    }
}

Uwagi

Identyfikatory obiektów kryptograficznych składają się z pary wartości/nazwy. Jeśli jedna właściwość w parze jest ustawiona na znaną wartość, druga właściwość zostanie automatycznie zaktualizowana do odpowiedniej wartości. Jeśli na przykład Value właściwość jest ustawiona na "1.3.6.1.5.5.7.3.4", FriendlyName właściwość, która jest zlokalizowana, jest ustawiana automatycznie na wartość "Bezpieczna wiadomość e-mail".

Konstruktory

Oid()

Inicjuje nowe wystąpienie klasy Oid.

Oid(Oid)

Inicjuje Oid nowe wystąpienie klasy przy użyciu określonego Oid obiektu.

Oid(String)

Inicjuje Oid nowe wystąpienie klasy przy użyciu wartości Oid ciągu obiektu.

Oid(String, String)

Inicjuje Oid nowe wystąpienie klasy przy użyciu określonej wartości i przyjaznej nazwy.

Właściwości

FriendlyName

Pobiera lub ustawia przyjazną nazwę identyfikatora.

Value

Pobiera lub ustawia kropkowaną liczbę identyfikatora.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FromFriendlyName(String, OidGroup)

Oid Tworzy obiekt na podstawie przyjaznej nazwy identyfikatora OID, wyszukując określoną grupę.

FromOidValue(String, OidGroup)

Oid Tworzy obiekt przy użyciu określonej wartości identyfikatora OID i grupy.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Produkt Wersje
.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 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