Codificaciones Base64, Base32 y Base16 en .NET

Codificación BaseN

Las codificaciones BaseN se utilizan para codificar datos binarios en texto. Donde N es el tamaño del alfabeto de texto utilizado para la codificación. Las codificaciones BaseN se utilizan para "preparar datos" para su transmisión a través de protocolos de texto (HTTP, SMTP) o canales no digitales (por ejemplo, impresión en papel).

La variante más popular de esta codificación es Base64 . Solo Base16 conocida como hexadecimal o simplemente hexadecimal se puede comparar en frecuencia de uso . Las herramientas para trabajar con ellos han estado en .NET desde las primeras versiones, pero no son muy convenientes.

Qué hay en .NET Framework (Core)

Sistema.Seguridad.Criptografía

ToBase64Transform / FromBase64Transform

Un par de clases para convertir a / desde Base64. Con la clase auxiliar CryptoStream , se puede usar para transmitir.

using System.Security.Cryptography;

var base64Transform = new ToBase64Transform();
var output = new MemoryStream();
var base64Encoder = new CryptoStream(output, base64Transform, CryptoStreamMode.Write);

base64Encoder.Write(new byte[] { 122 }, 0, 1);
base64Encoder.Close();
// output.ToArray() -> byte[4] { 101, 103, 61, 61 } aka "eg=="

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

System.Convert

ToBase64String / FromBase64String

Un par de funciones para convertir una matriz de bytes en una cadena Base64 y viceversa.

using System;

var bytes = System.Convert.FromBase64String("eg==")
// bytes -> 122
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

System.BitConverter

BitConverter.ToString

Una función para convertir una matriz de bytes en una cadena Base16 (hexadecimal), donde cada byte está separado por un guión. Ejemplo: 0A-C0-D3

using System;

var hexString = BitConverter.ToString(new byte[] { 122, 122 });
// hexString -> "7A-7A"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

System.Runtime.Remoting.Metadata.W3cXsd2001

SoapHexBinary (solo marco)

Una clase que le permite convertir una matriz de bytes en una cadena Base16 (hexadecimal) y viceversa.

using System.Runtime.Remoting.Metadata.W3cXsd2001;

var result = SoapHexBinary.Parse("A012");
// result.Value -> byte[];
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

System.Buffers.Text

Base64 (Core or System.Memory package)

Base64 . Span' Span .

Nuget

Multiformats.Base - Base2, 8, 16, 32, 58, 64 (+variants), MIT

BaseN . API . : .

SimpleBase - Base16, 32, 58, 85 (+variants), streaming, span, Apache-2

BaseN . .NET Core Span'. API, .

deniszykov.BaseN

.

, .NET Framework 4.5.

, Base64 Span<byte> to Span<byte> ( char[] <-> byte[] ). , . "" byte char , char 2 . .. , , .

/ :

• byte[]

  
  
  
  
  

• char[]

  
  
  
  
  

• string

  
  
  
  
  

• byte*

  
  
  
  
  

• char*

  
  
  
  
  

• Span<byte>

  
  
  
  
  

• Span<char>

  
  
  
  
  

Todo esto se encuentra dentro de las dos clases BaseNDecoder / BaseNEncoder .

Se admiten los siguientes diccionarios de codificación:

• Base16 (hexadecimal / inferior / superior)

  
  
  
  
  

• Base32

  
  
  
  
  

• ZBase32

  
  
  
  
  

• Base64

  
  
  
  
  

• Base64 Url-safe

  
  
  
  
  

using deniszykov.BaseN;

var bytes = Base64Convert.ToBytes("eg==");
// bytes[0] -> 122
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

Un conjunto más rico ofrece la clase BaseNEncoding que implementa System.Text.Encoding .

using deniszykov.BaseN;

var count = BaseNEncoding.Base64Url.GetByteCount("eg=="); // -> 1
var bytes = BaseNEncoding.Base64Url.GetBytes("eg=="); // -> 122

var baseNEncoder = new BaseNEncoder(BaseNAlphabet.Base64Alphabet);
var input = "eg==";
var output = new byte[1024];
baseNEncoder.Convert(input, 0, 4, output, 0, 1, true, out var charsUsed, out var bytesUsed, out var completed);
// output[0] -> 122

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

Otros ejemplos de uso "simple" se encuentran aquí . Puede utilizar su propio diccionario. No habrá ejemplos complejos, quienes lo necesiten pueden encontrarlos en pruebas :)

Install-Package deniszykov.BaseN