UTF8Encoding.GetEncoder Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Text
Bütünleştirilmiş Kod:
System.Text.Encoding.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Unicode karakter dizisini UTF-8 kodlanmış bayt dizisine dönüştüren bir kodlayıcı alır.

public:
 override System::Text::Encoder ^ GetEncoder();
public override System.Text.Encoder GetEncoder ();
override this.GetEncoder : unit -> System.Text.Encoder
Public Overrides Function GetEncoder () As Encoder

Döndürülenler

Encoder

Unicode Encoder karakter dizisini UTF-8 ile kodlanmış bayt dizisine dönüştüren bir.

Örnekler

Aşağıdaki örnek, bir karakter dizisini GetEncoder UTF-8 kodlanmış bayt dizisine dönüştürmek için kodlayıcı elde etmek için yöntemini kullanır.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars = {'a','b','c',L'\u0300',L'\ua0a0'};
   array<Byte>^bytes;
   Encoder^ utf8Encoder = Encoding::UTF8->GetEncoder();
   int byteCount = utf8Encoder->GetByteCount( chars, 2, 3, true );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf8Encoder->GetBytes( chars, 2, 3, bytes, 0, true );
   Console::WriteLine( "{0} bytes used to encode characters.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Char[] chars = new Char[] {'a', 'b', 'c', '\u0300', '\ua0a0'};
        Byte[] bytes;

        Encoder utf8Encoder = Encoding.UTF8.GetEncoder();

        int byteCount = utf8Encoder.GetByteCount(chars, 2, 3, true);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8Encoder.GetBytes(chars, 2, 3, bytes, 0, true);

        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        'Characters:
        ' ChrW(97) = a
        ' ChrW(98) = b
        ' ChrW(99) = c
        ' ChrW(768) = `
        ' ChrW(41120) = valid unicode code point, but not a character
        Dim chars() As Char = {ChrW(97), ChrW(98), ChrW(99), ChrW(768), ChrW(41120)}
        Dim bytes() As Byte
        
        Dim utf8Encoder As Encoder = Encoding.UTF8.GetEncoder()
        
        Dim byteCount As Integer = utf8Encoder.GetByteCount(chars, 2, 3, True)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8Encoder.GetBytes( _
            chars, 2, 3, bytes, 0, True _
        )
        
        Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Açıklamalar

yöntemi, Encoder.GetBytes sıralı karakter bloklarını yöntemine benzer şekilde sıralı bayt bloklarına GetBytes dönüştürür. Ancak, blokları Encoder kapsayan karakter dizilerini doğru şekilde kodlamak için çağrılar arasında durum bilgilerini korur. ayrıca Encoder veri bloklarının sonundaki karakterleri korur ve sonraki kodlama işleminde sondaki karakterleri kullanır. Örneğin, bir veri bloğu eşleşmeyen bir yüksek vekille bitebilir ve eşleşen düşük vekil sonraki veri bloğunda olabilir. Bu nedenle ve GetDecoder GetEncoder ağ iletimi ve dosya işlemleri için yararlıdır çünkü bu işlemler genellikle tam bir veri akışı yerine veri bloklarıyla ilgilenir.

Hata algılama etkinleştirilirse, throwOnInvalidCharacters yani oluşturucunun parametresi olarak ayarlanır true, hata algılama da bu yöntem tarafından döndürülen içinde Encoder etkinleştirilir. Hata algılama etkinse ve geçersiz bir diziyle karşılaşılırsa kodlayıcının durumu tanımlanmamıştır ve işleme durdurulmalıdır.

Şunlara uygulanır

Ayrıca bkz.