UTF8Encoding.GetBytes Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Bir karakter kümesini bayt dizisine kodlar.

Aşırı Yüklemeler

GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Belirtilen karakter aralığını belirtilen bayt aralığına kodlar.
GetBytes(Char*, Int32, Byte*, Int32)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini, belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.
GetBytes(String, Int32, Int32, Byte[], Int32)	Belirtilenden bir karakter kümesini belirtilen String bayt dizisine kodlar.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Kaynak:

UTF8Encoding.cs

Belirtilen karakter aralığını belirtilen bayt aralığına kodlar.

public:
 override int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes);

public override int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes);

override this.GetBytes : ReadOnlySpan<char> * Span<byte> -> int

Public Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integer

Parametreler

chars

ReadOnlySpan<Char>

Karakter kodlamaya yayılır.

bytes

Span<Byte>

Elde edilen bayt kümesini içeren yayılma alanı.

Döndürülenler

Int32

içine bytesyazılan gerçek bayt sayısı.

Açıklamalar

Sonucu elde edilen baytları depolamak için tarafından GetBytes gereken tam boyutu hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük boyutu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin özel durum ArgumentException oluşturmasına neden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, sırasıyla yöntemi veya yöntemi tarafından GetDecoder döndürülen veya GetEncoderEncoder kullanınDecoder.

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının ön ekini bir ön ekine ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. yöntemi, GetBytes kodlanmış bayt dizisinin başına bir ön adım eklemez.

GetBytes(Char*, Int32, Byte*, Int32)

Kaynak:

UTF8Encoding.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen karakter işaretçisinde başlayan bir karakter kümesini, belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.

public:
 override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);

[System.CLSCompliant(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);

[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Parametreler

chars

Char*

Kodlanacak ilk karakterin işaretçisi.

charCount

Int32

Kodlanacak karakter sayısı.

bytes

Byte*

Elde edilen bayt sırasını yazmaya başlanması gereken konuma yönelik bir işaretçi.

byteCount

Int32

Yazacak en fazla bayt sayısı.

Döndürülenler

Int32

tarafından bytesbelirtilen konumda yazılan gerçek bayt sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

chars, null değeridir.

-veya-

bytes, null değeridir.

ArgumentOutOfRangeException

charCount veya byteCount sıfırdan küçüktür.

ArgumentException

Hata algılama etkinleştirildi ve chars geçersiz karakter dizisi içeriyor.

-veya-

byteCount elde edilen bayt sayısından küçüktür.

EncoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Açıklamalar

Sonucu elde edilen baytları depolamak için tarafından GetBytes gereken dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin özel durum ArgumentException oluşturmasına neden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, sırasıyla yöntemi veya yöntemi tarafından GetDecoder döndürülen veya GetEncoderEncoder kullanınDecoder.

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının ön ekini bir ön ekine ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. yöntemi, GetBytes kodlanmış bayt dizisinin başına bir ön adım eklemez.

Ayrıca bkz.

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Kaynak:

UTF8Encoding.cs

Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.

public:
 override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);

public override int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);

override this.GetBytes : char[] * int * int * byte[] * int -> int

Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametreler

chars

Char[]

Kodlanması gereken karakter kümesini içeren karakter dizisi.

charIndex

Int32

Kodlanacak ilk karakterin dizini.

charCount

Int32

Kodlanacak karakter sayısı.

bytes

Byte[]

Elde edilen bayt dizisini içeren bayt dizisi.

byteIndex

Int32

Elde edilen bayt sırasını yazmaya başlanması gereken dizin.

Döndürülenler

Int32

içine bytesyazılan gerçek bayt sayısı.

Özel durumlar

ArgumentNullException

chars, null değeridir.

-veya-

bytes, null değeridir.

ArgumentOutOfRangeException

charIndex veya charCountbyteIndex sıfırdan küçüktür.

-veya-

charIndex ve charCount içinde charsgeçerli bir aralığı ifade etmeyin.

-veya-

byteIndex içinde bytesgeçerli bir dizin değil.

ArgumentException

Hata algılama etkinleştirildi ve chars geçersiz karakter dizisi içeriyor.

-veya-

bytes dizinin sonundan elde edilen baytları barındırmak için yeterli kapasiteye byteIndex sahip değildir.

EncoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Örnekler

Aşağıdaki örnek, bir dizedeki karakter aralığını kodlamak için yöntemini kullanır GetBytes ve kodlanmış baytları bayt dizisindeki bir öğe aralığında depolar.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "UTF8 Encoding Example";
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = utf8->GetByteCount( chars->ToCharArray(), 0, 13 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf8->GetBytes( chars, 0, 13, bytes, 0 );
   Console::WriteLine( "{0} bytes used to encode string.", 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() {
        Byte[] bytes;
        String chars = "UTF8 Encoding Example";
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars.ToCharArray(), 0, 13);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 0, 13, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

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

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "UTF8 Encoding Example"
        
        Dim utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars.ToCharArray(), 0, 13)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 0, 13, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", 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

Sonucu elde edilen baytları depolamak için tarafından GetBytes gereken dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin özel durum ArgumentException oluşturmasına neden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, Decoder sırasıyla yöntemi veya yöntemi tarafından GetDecoder sağlanan veya EncoderGetEncoder kullanın.

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının ön ekini bir ön ekine ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. yöntemi, GetBytes kodlanmış bayt dizisinin başına bir ön adım eklemez.

Ayrıca bkz.

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)

GetBytes(String, Int32, Int32, Byte[], Int32)

Kaynak:

UTF8Encoding.cs

Belirtilen içindeki bir karakter kümesini belirtilen String bayt dizisine kodlar.

public:
 override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);

public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);

override this.GetBytes : string * int * int * byte[] * int -> int

Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametreler

s

String

String Kodlanması gereken karakter kümesini içeren.

charIndex

Int32

Kodlanan ilk karakterin dizini.

charCount

Int32

Kodlanacak karakter sayısı.

bytes

Byte[]

Elde edilen bayt dizisini içeren bayt dizisi.

byteIndex

Int32

Elde edilen bayt sırasını yazmaya başlayabileceğiniz dizin.

Döndürülenler

Int32

içine bytesyazılan gerçek bayt sayısı.

Özel durumlar

ArgumentNullException

s, null değeridir.

-veya-

bytes, null değeridir.

ArgumentOutOfRangeException

charIndex veya charCountbyteIndex sıfırdan küçüktür.

-veya-

charIndex ve charCount içinde charsgeçerli bir aralığı ifade etmeyin.

-veya-

byteIndex içinde bytesgeçerli bir dizin değil.

ArgumentException

Hata algılama etkinleştirildi ve s geçersiz karakter dizisi içeriyor.

-veya-

bytes , sonuçta elde edilen baytları barındırmak için dizinin sonuna kadar yeterli kapasiteye byteIndex sahip değildir.

EncoderFallbackException

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Örnekler

Aşağıdaki örnek, Unicode karakter dizisindeki bir öğe aralığını kodlamak ve kodlanmış baytları bayt dizisindeki bir öğe aralığında depolamak için yöntemini kullanır GetBytes .

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = utf8->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf8->GetBytes( chars, 1, 2, bytes, 0 );
   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() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 1, 2, bytes, 0);
        
        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()
        Dim bytes() As Byte
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}
        
        Dim utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 1, 2, bytes, 0)
        
        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

Sonucu elde edilen baytları depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin özel durum ArgumentException oluşturmasına neden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Bir akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, Decoder sırasıyla yöntemi veya yöntemi tarafından GetDecoder sağlanan veya EncoderGetEncoder kullanın.

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının önüne bir ön ek ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. GetBytes yöntemi, kodlanmış bayt dizisinin başına bir ön ek ekleme yapmaz.

Ayrıca bkz.

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)