AsnEncodedData AsnEncodedData AsnEncodedData AsnEncodedData Class

Définition

Représente des données encodées ASN.1 (Abstract Syntax Notation One).Represents Abstract Syntax Notation One (ASN.1)-encoded data.

public ref class AsnEncodedData
public class AsnEncodedData
type AsnEncodedData = class
Public Class AsnEncodedData
Héritage
AsnEncodedDataAsnEncodedDataAsnEncodedDataAsnEncodedData
Dérivé

Exemples

L'exemple de code suivant montre comment utiliser la classe AsnEncodedData.The following code example shows how to use the AsnEncodedData class.

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

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Cryptography::X509Certificates;

int main()
{
   
   //The following example demonstrates the usage of the AsnEncodedData classes.
   // Asn encoded data is read from the extensions of an X509 certificate.
   try
   {
      
      // Open the certificate store.
      X509Store^ store = gcnew X509Store( L"MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection^ fcollection = dynamic_cast<X509Certificate2Collection^>(collection->Find( X509FindType::FindByTimeValid, DateTime::Now, false ));
      
      // Select one or more certificates to display extensions information.
      X509Certificate2Collection^ scollection = X509Certificate2UI::SelectFromCollection(fcollection, L"Certificate Select",L"Select certificates from the following list to get extension information on that certificate",X509SelectionFlag::MultiSelection);
      
      // Create a new AsnEncodedDataCollection object.
      AsnEncodedDataCollection^ asncoll = gcnew AsnEncodedDataCollection;
      for ( int i = 0; i < scollection->Count; i++ )
      {
         
         // Display certificate information.
         Console::ForegroundColor = ConsoleColor::Red;
         Console::WriteLine( L"Certificate name: {0}", scollection[i]->GetName() );
         Console::ResetColor();
         
         // Display extensions information.
         System::Collections::IEnumerator^ myEnum = scollection[i]->Extensions->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            X509Extension^ extension = safe_cast<X509Extension ^>(myEnum->Current);
            
            // Create an AsnEncodedData object using the extensions information.
            AsnEncodedData^ asndata = gcnew AsnEncodedData( extension->Oid,extension->RawData );
            Console::ForegroundColor = ConsoleColor::Green;
            Console::WriteLine( L"Extension type: {0}", extension->Oid->FriendlyName );
            Console::WriteLine( L"Oid value: {0}", asndata->Oid->Value );
            Console::WriteLine( L"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( L"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( L"First AsnEncodedData in the collection: {0}", asne->Current->Format(true) );
      Console::ResetColor();
      asne->MoveNext();
      Console::ForegroundColor = ConsoleColor::DarkBlue;
      Console::WriteLine( L"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( L"Information could not be written out for this certificate." );
   }

   return 1;
}
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 'Main
End Class 'AsnEncodedDataSample

Remarques

La notation de syntaxe abstraite One (ASN. 1), qui est définie dans la recommandation CCITT X. 208, est un moyen de spécifier des objets abstraits qui seront transmis en série.Abstract Syntax Notation One (ASN.1), which is defined in CCITT Recommendation X.208, is a way to specify abstract objects that will be serially transmitted. Le jeu de règles ASN. 1 pour représenter des objets de ce type en tant que chaînes de uns et de zéros est appelé le Distinguished Encoding Rules (DER) et est défini dans la recommandation CCITT X. 509, section 8,7.The set of ASN.1 rules for representing such objects as strings of ones and zeros is called the Distinguished Encoding Rules (DER), and is defined in CCITT Recommendation X.509, Section 8.7. Ces méthodes d’encodage sont actuellement utilisées par l’espace de noms Cryptography dans la .NET Framework.These encoding methods are currently used by the cryptography namespace in the .NET Framework.

Notez que si un type de données inconnu est rencontré lors de l’accès à une instance de cette classe, les données sont retournées sous forme de chaîne hexadécimale.Note that if an unknown data type is encountered while accessing an instance of this class, data is returned as a hexadecimal string.

Constructeurs

AsnEncodedData() AsnEncodedData() AsnEncodedData() AsnEncodedData()

Initialise une nouvelle instance de la classe AsnEncodedData.Initializes a new instance of the AsnEncodedData class.

AsnEncodedData(AsnEncodedData) AsnEncodedData(AsnEncodedData) AsnEncodedData(AsnEncodedData) AsnEncodedData(AsnEncodedData)

Initialise une nouvelle instance de la classe AsnEncodedData à l'aide d'une instance de la classe AsnEncodedData.Initializes a new instance of the AsnEncodedData class using an instance of the AsnEncodedData class.

AsnEncodedData(Byte[]) AsnEncodedData(Byte[]) AsnEncodedData(Byte[]) AsnEncodedData(Byte[])

Initialise une nouvelle instance de la classe AsnEncodedData à l'aide d'un tableau d'octets.Initializes a new instance of the AsnEncodedData class using a byte array.

AsnEncodedData(Oid, Byte[]) AsnEncodedData(Oid, Byte[]) AsnEncodedData(Oid, Byte[]) AsnEncodedData(Oid, Byte[])

Initialise une nouvelle instance de la classe AsnEncodedData à l'aide d'un objet Oid et d'un tableau d'octets.Initializes a new instance of the AsnEncodedData class using an Oid object and a byte array.

AsnEncodedData(String, Byte[]) AsnEncodedData(String, Byte[]) AsnEncodedData(String, Byte[]) AsnEncodedData(String, Byte[])

Initialise une nouvelle instance de la classe AsnEncodedData à l'aide d'un tableau d'octets.Initializes a new instance of the AsnEncodedData class using a byte array.

Propriétés

Oid Oid Oid Oid

Obtient ou définit la valeur Oid pour un objet AsnEncodedData.Gets or sets the Oid value for an AsnEncodedData object.

RawData RawData RawData RawData

Obtient ou définit les données encodées ASN.1 (Abstract Syntax Notation One) représentées dans un tableau d'octets.Gets or sets the Abstract Syntax Notation One (ASN.1)-encoded data represented in a byte array.

Méthodes

CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData)

Copie les informations d'un objet AsnEncodedData.Copies information from an AsnEncodedData object.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Format(Boolean) Format(Boolean) Format(Boolean) Format(Boolean)

Retourne une version mise en forme des données encodées ASN.1 (Abstract Syntax Notation One) sous forme de chaîne.Returns a formatted version of the Abstract Syntax Notation One (ASN.1)-encoded data as a string.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à