AsnEncodedData Klasse

Definition

Stellt abstrakte Syntaxnotation One (ASN.1)-codierte Daten dar.

public ref class AsnEncodedData
public class AsnEncodedData
type AsnEncodedData = class
Public Class AsnEncodedData
Vererbung
AsnEncodedData
Abgeleitet

Beispiele

Das folgende Codebeispiel zeigt, wie die AsnEncodedData Klasse verwendet wird.

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

class AsnEncodedDataSample
{
    static void Main()
    {		
        //The following example demonstrates the usage the AsnEncodedData classes.
        // Asn encoded data is read from the extensions of an X509 certificate.
        try
        {
            // Open the certificate store.
            X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
            store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
            X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
            X509Certificate2Collection fcollection = (X509Certificate2Collection)collection.Find(X509FindType.FindByTimeValid, DateTime.Now, false);
            // Select one or more certificates to display extensions information.
            X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(fcollection, "Certificate Select", "Select certificates from the following list to get extension information on that certificate", X509SelectionFlag.MultiSelection);

            // Create a new AsnEncodedDataCollection object.
            AsnEncodedDataCollection asncoll = new AsnEncodedDataCollection();
            for (int i = 0; i < scollection.Count; i++)
            {
                // Display certificate information.
                Console.ForegroundColor = ConsoleColor.Red;
                Console.WriteLine("Certificate name: {0}", scollection[i].GetName());
                Console.ResetColor();
                // Display extensions information.
                foreach (X509Extension extension in scollection[i].Extensions)
                {
                    // Create an AsnEncodedData object using the extensions information.
                    AsnEncodedData asndata = new AsnEncodedData(extension.Oid, extension.RawData);
                    Console.ForegroundColor = ConsoleColor.Green;
                    Console.WriteLine("Extension type: {0}", extension.Oid.FriendlyName);
                    Console.WriteLine("Oid value: {0}",asndata.Oid.Value);
                    Console.WriteLine("Raw data length: {0} {1}", asndata.RawData.Length, Environment.NewLine);
                    Console.ResetColor();
                    Console.WriteLine(asndata.Format(true));
                    Console.WriteLine(Environment.NewLine);
                    // Add the AsnEncodedData object to the AsnEncodedDataCollection object.
                    asncoll.Add(asndata);
                }
                Console.WriteLine(Environment.NewLine);
            }
            Console.ForegroundColor = ConsoleColor.Red;
            Console.WriteLine("Number of AsnEncodedData items in the collection: {0} {1}", asncoll.Count, Environment.NewLine);
            Console.ResetColor();

            store.Close();
            //Create an enumerator for moving through the collection.
            AsnEncodedDataEnumerator asne = asncoll.GetEnumerator();
            //You must execute a MoveNext() to get to the first item in the collection.
            asne.MoveNext();
            // Write out AsnEncodedData in the collection.
            Console.ForegroundColor = ConsoleColor.Blue;
            Console.WriteLine("First AsnEncodedData in the collection: {0}", asne.Current.Format(true));
            Console.ResetColor();

            asne.MoveNext();
            Console.ForegroundColor = ConsoleColor.DarkBlue;
            Console.WriteLine("Second AsnEncodedData in the collection: {0}", asne.Current.Format(true));
            Console.ResetColor();
            //Return index in the collection to the beginning.
            asne.Reset();
        }
        catch (CryptographicException)
        {
            Console.WriteLine("Information could not be written out for this certificate.");
        }
    }
}
Imports System.Security.Cryptography
Imports System.Security.Cryptography.X509Certificates



Class AsnEncodedDataSample
   Shared msg As String
   Shared Sub Main()
      'The following example demonstrates the usage the AsnEncodedData classes.
      ' Asn encoded data is read from the extensions of an X509 certificate.
      Try
         ' Open the certificate store.
         Dim store As New X509Store("MY", StoreLocation.CurrentUser)
         store.Open((OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly))
         Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
         Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
         ' Select one or more certificates to display extensions information.
         Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(fcollection, "Certificate Select", "Select certificates from the following list to get extension information on that certificate", X509SelectionFlag.MultiSelection)
         
         ' Create a new AsnEncodedDataCollection object.
         Dim asncoll As New AsnEncodedDataCollection()
         Dim i As Integer
         For i = 0 To scollection.Count - 1
            ' Display certificate information.
        msg = "Certificate name: "& scollection(i).GetName()
            MsgBox(msg)

            ' Display extensions information.
            Dim extension As X509Extension
            For Each extension In  scollection(i).Extensions
               ' Create an AsnEncodedData object using the extensions information.
               Dim asndata As New AsnEncodedData(extension.Oid, extension.RawData)
           msg = "Extension type: " & extension.Oid.FriendlyName & Environment.NewLine & "Oid value: " & asndata.Oid.Value _
        & Environment.NewLine & "Raw data length: " & asndata.RawData.Length & Environment.NewLine _
        & asndata.Format(True) & Environment.NewLine
               MsgBox(msg)
        
               ' Add the AsnEncodedData object to the AsnEncodedDataCollection object.
               asncoll.Add(asndata)
            Next extension
         Next i
     msg = "Number of AsnEncodedData items in the collection: " & asncoll.Count
         MsgBox(msg)         
         store.Close()

         'Create an enumerator for moving through the collection.
         Dim asne As AsnEncodedDataEnumerator = asncoll.GetEnumerator()
         'You must execute a MoveNext() to get to the first item in the collection.
         asne.MoveNext()
         ' Write out AsnEncodedData in the collection.
     msg = "First AsnEncodedData in the collection: " & asne.Current.Format(True)
     MsgBox(msg)
    
         
         asne.MoveNext()
     msg = "Second AsnEncodedData in the collection: " & asne.Current.Format(True)
     MsgBox(msg)
        
         'Return index in the collection to the beginning.
         asne.Reset()
      Catch 
         MsgBox("Information could not be written out for this certificate.")
      End Try
   End Sub
End Class

Hinweise

Abstrakte Syntaxnotation One (ASN.1), die in CCITT Empfehlung X.208 definiert ist, ist eine Möglichkeit, abstrakte Objekte anzugeben, die serial übertragen werden. Der Satz von ASN.1-Regeln für die Darstellung von Objekten wie Zeichenfolgen von Einsen und Nullen wird als Distinguished Encoding Rules (DER) bezeichnet und in CCITT Empfehlung X.509, Abschnitt 8.7, definiert. Diese Codierungsmethoden werden derzeit vom Kryptografienamespace im .NET Framework verwendet.

Beachten Sie, dass Daten als hexadezimale Zeichenfolge zurückgegeben werden, wenn beim Zugriff auf eine Instanz dieser Klasse ein unbekannter Datentyp auftritt.

Konstruktoren

Name Beschreibung
AsnEncodedData()

Initialisiert eine neue Instanz der AsnEncodedData-Klasse.

AsnEncodedData(AsnEncodedData)

Initialisiert eine neue Instanz der AsnEncodedData Klasse mithilfe einer Instanz der AsnEncodedData Klasse.

AsnEncodedData(Byte[])

Initialisiert eine neue Instanz der AsnEncodedData Klasse mithilfe eines Bytearrays.

AsnEncodedData(Oid, Byte[])

Initialisiert eine neue Instanz der AsnEncodedData Klasse mithilfe eines Oid Objekts und eines Bytearrays.

AsnEncodedData(Oid, ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der AsnEncodedData Klasse aus einem Objektbezeichner (OID) und vorhandenen codierten Daten.

AsnEncodedData(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der AsnEncodedData Klasse aus vorhandenen codierten Daten.

AsnEncodedData(String, Byte[])

Initialisiert eine neue Instanz der AsnEncodedData Klasse mithilfe eines Bytearrays.

AsnEncodedData(String, ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der AsnEncodedData Klasse aus einem Objektbezeichner (OID) und vorhandenen codierten Daten.

Eigenschaften

Name Beschreibung
Oid

Dient zum Abrufen oder Festlegen des Oid Werts für ein AsnEncodedData Objekt.

RawData

Ruft ab oder legt die abstrakte Syntax Notation One (ASN.1)-codierte Daten in einem Bytearray dargestellt.

Methoden

Name Beschreibung
CopyFrom(AsnEncodedData)

Kopiert Informationen aus einem AsnEncodedData Objekt.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Format(Boolean)

Gibt eine formatierte Version der abstrakten Syntax Notation One (ASN.1)-codierte Daten als Zeichenfolge zurück.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für: