AsnEncodedData Classe
Definição
Representa dados codificados por ASN.1 (Abstract Syntax Notation Um).Represents Abstract Syntax Notation One (ASN.1)-encoded data.
public ref class AsnEncodedData
public class AsnEncodedData
type AsnEncodedData = class
Public Class AsnEncodedData
- Herança
-
AsnEncodedData
- Derivado
Exemplos
O exemplo de código a seguir mostra como usar a AsnEncodedData classe.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
End Class
Comentários
A predefinição de notação de sintaxe abstrata (ASN. 1), que é definida na recomendação de CCITT X. 208, é uma maneira de especificar objetos abstratos que serão transmitidos em 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. O conjunto de regras de ASN. 1 para representar esses objetos como cadeias de caracteres e zeros é chamado de Distinguished Encoding Rules (DER) e é definido na recomendação de CCITT X. 509, seção 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. Esses métodos de codificação são usados atualmente pelo namespace de criptografia no .NET Framework.These encoding methods are currently used by the cryptography namespace in the .NET Framework.
Observe que, se um tipo de dados desconhecido for encontrado ao acessar uma instância dessa classe, os dados serão retornados como uma cadeia de caracteres hexadecimal.Note that if an unknown data type is encountered while accessing an instance of this class, data is returned as a hexadecimal string.
Construtores
| AsnEncodedData() |
Inicializa uma nova instância da classe AsnEncodedData.Initializes a new instance of the AsnEncodedData class. |
| AsnEncodedData(AsnEncodedData) |
Inicializa uma nova instância da classe AsnEncodedData usando uma instância da classe AsnEncodedData.Initializes a new instance of the AsnEncodedData class using an instance of the AsnEncodedData class. |
| AsnEncodedData(Byte[]) |
Inicializa uma nova instância da classe AsnEncodedData usando uma matriz de bytes.Initializes a new instance of the AsnEncodedData class using a byte array. |
| AsnEncodedData(Oid, Byte[]) |
Inicializa uma nova instância da classe AsnEncodedData usando um objeto Oid e uma matriz de bytes.Initializes a new instance of the AsnEncodedData class using an Oid object and a byte array. |
| AsnEncodedData(Oid, ReadOnlySpan<Byte>) |
Inicializa uma nova instância da classe AsnEncodedData a partir de um OID (identificador de objeto) e dos dados codificados existentes.Initializes a new instance of the AsnEncodedData class from an object identifier (OID) and existing encoded data. |
| AsnEncodedData(ReadOnlySpan<Byte>) |
Inicializa uma nova instância da classe AsnEncodedData a partir dos dados codificados existentes.Initializes a new instance of the AsnEncodedData class from existing encoded data. |
| AsnEncodedData(String, Byte[]) |
Inicializa uma nova instância da classe AsnEncodedData usando uma matriz de bytes.Initializes a new instance of the AsnEncodedData class using a byte array. |
| AsnEncodedData(String, ReadOnlySpan<Byte>) |
Inicializa uma nova instância da classe AsnEncodedData a partir de um OID (identificador de objeto) e dos dados codificados existentes.Initializes a new instance of the AsnEncodedData class from an object identifier (OID) and existing encoded data. |
Propriedades
| Oid |
Obtém ou define o valor Oid para um objeto AsnEncodedData.Gets or sets the Oid value for an AsnEncodedData object. |
| RawData |
Obtém ou define os dados codificados em ASN.1 (Abstract Syntax Notation One) representados em uma matriz de bytes.Gets or sets the Abstract Syntax Notation One (ASN.1)-encoded data represented in a byte array. |
Métodos
| CopyFrom(AsnEncodedData) |
Copia informações de um objeto AsnEncodedData.Copies information from an AsnEncodedData object. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| Format(Boolean) |
Retorna uma versão formatada dos dados codificados em ASN.1 (Abstract Syntax Notation One) como uma cadeia de caracteres.Returns a formatted version of the Abstract Syntax Notation One (ASN.1)-encoded data as a string. |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |