UTF7Encoding.GetDecoder Método
Definición
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í.
Obtiene un descodificador que convierte una secuencia de bytes codificada en UTF-7 en una secuencia de caracteres Unicode.
public:
override System::Text::Decoder ^ GetDecoder();
public override System.Text.Decoder GetDecoder ();
override this.GetDecoder : unit -> System.Text.Decoder
Public Overrides Function GetDecoder () As Decoder
Devoluciones
Objeto Decoder que convierte una secuencia de bytes codificada en UTF-7 en una secuencia de caracteres Unicode.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el GetDecoder método para obtener un descodificador para convertir los bytes codificados UTF-7 en una secuencia de caracteres.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Char>^chars;
array<Byte>^bytes = {99,43,65,119,67,103,111,65,45};
Decoder^ utf7Decoder = Encoding::UTF7->GetDecoder();
int charCount = utf7Decoder->GetCharCount( bytes, 0, bytes->Length );
chars = gcnew array<Char>(charCount);
int charsDecodedCount = utf7Decoder->GetChars( bytes, 0, bytes->Length, chars, 0 );
Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
Console::Write( "Decoded chars: " );
IEnumerator^ myEnum = chars->GetEnumerator();
while ( myEnum->MoveNext() )
{
Char c = safe_cast<Char>(myEnum->Current);
Console::Write( "[{0}]", c.ToString() );
}
Console::WriteLine();
}
using System;
using System.Text;
class UTF7EncodingExample {
public static void Main() {
Char[] chars;
Byte[] bytes = new Byte[] {
99, 43, 65, 119, 67, 103, 111, 65, 45
};
Decoder utf7Decoder = Encoding.UTF7.GetDecoder();
int charCount = utf7Decoder.GetCharCount(bytes, 0, bytes.Length);
chars = new Char[charCount];
int charsDecodedCount = utf7Decoder.GetChars(bytes, 0, bytes.Length, chars, 0);
Console.WriteLine(
"{0} characters used to decode bytes.", charsDecodedCount
);
Console.Write("Decoded chars: ");
foreach (Char c in chars) {
Console.Write("[{0}]", c);
}
Console.WriteLine();
}
}
Imports System.Text
Class UTF7EncodingExample
Public Shared Sub Main()
Dim chars() As Char
Dim bytes() As Byte = {99, 43, 65, 119, 67, 103, 111, 65, 45}
Dim utf7Decoder As Decoder = Encoding.UTF7.GetDecoder()
Dim charCount As Integer = utf7Decoder.GetCharCount(bytes, 0, bytes.Length)
chars = New Char(charCount - 1) {}
Dim charsDecodedCount As Integer = utf7Decoder.GetChars(bytes, 0, bytes.Length, chars, 0)
Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)
Console.Write("Decoded chars: ")
Dim c As Char
For Each c In chars
Console.Write("[{0}]", c)
Next c
Console.WriteLine()
End Sub
End Class
Comentarios
El Decoder.GetChars método convierte bloques secuenciales de bytes en bloques secuenciales de caracteres, de manera similar al GetChars método de esta clase. Sin embargo, un Decoder objeto mantiene información de estado entre las llamadas para que pueda descodificar correctamente las secuencias de bytes que abarcan bloques. DecoderTambién conserva los bytes finales al final de los bloques de datos y usa los bytes finales en la siguiente operación de descodificación. Por lo tanto, GetDecoder y GetEncoder son útiles para la transmisión de red y las operaciones de archivos, ya que estas operaciones suelen tratar con bloques de datos en lugar de con una secuencia de datos completa.