AsnEncodedData.Format(Boolean) Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una versión con formato de los datos codificados mediante Notación de sintaxis abstracta uno (ASN.1, Abstract Syntax Notation One) como una cadena.
public:
virtual System::String ^ Format(bool multiLine);
public virtual string Format (bool multiLine);
abstract member Format : bool -> string
override this.Format : bool -> string
Public Overridable Function Format (multiLine As Boolean) As String
- multiLine
- Boolean
Es true
si la cadena de retorno debe contener los retornos de carro; de lo contrario, es false
.
Cadena con formato que representa los datos codificados mediante Notación de sintaxis abstracta uno (ASN.1, Abstract Syntax Notation One).
En el ejemplo de código siguiente se muestra cómo se utiliza la clase AsnEncodedData.
#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
Use este método si necesita imprimir datos codificados con notación de sintaxis abstracta uno (ASN.1) o generar la información en un cuadro de texto. Use el multiLine
parámetro para controlar el diseño de la salida.
No confíe en la salida de este método, ya que está pensada para la impresión bonita y no se garantiza su formato de salida.
extension.Format(true);
// output "DNS Name=san1.example.com\r\nDNS Name=san2.example.com\r\n" on .NET Core 2.2 Windows
// output "DNS:san1.example.com, DNS:san2.example.com" on .NET Core 2.2 Linux
Producto | Versiones |
---|---|
.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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: