Encoding.GetBytes Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

mscorlib.dll

Türetilmiş bir sınıfta geçersiz kılındığında, bir karakter kümesini bayt dizisine kodlar.

Aşırı Yüklemeler

Name	Description
GetBytes(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar.
GetBytes(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar.
GetBytes(Char*, Int32, Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, 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)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini belirtilen bayt dizisine kodlar.
GetBytes(String, Int32, Int32, Byte[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.

GetBytes(Char[])

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar.

public:
 virtual cli::array <System::Byte> ^ GetBytes(cli::array <char> ^ chars);

public virtual byte[] GetBytes(char[] chars);

abstract member GetBytes : char[] -> byte[]
override this.GetBytes : char[] -> byte[]

Public Overridable Function GetBytes (chars As Char()) As Byte()

Parametreler

chars

Char[]

Kodlanması gereken karakterleri içeren karakter dizisi.

Döndürülenler

Byte[]

Belirtilen karakter kümesini kodlama sonuçlarını içeren bayt dizisi.

Özel durumlar

ArgumentNullException

chars, null'e eşittir.

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 karakter dizisini kodlamak için gereken bayt sayısını belirler, karakterleri kodlar ve sonuçta elde edilen baytları görüntüler.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' };

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode the entire array, and print out the counts and the resulting bytes.
      PrintCountsAndBytes( myChars, u7 );
      PrintCountsAndBytes( myChars, u8 );
      PrintCountsAndBytes( myChars, u16LE );
      PrintCountsAndBytes( myChars, u16BE );
      PrintCountsAndBytes( myChars, u32 );
   }

   public static void PrintCountsAndBytes( char[] chars, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( chars );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( chars.Length );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the array of chars.
      byte[] bytes = enc.GetBytes( chars );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF)}
 

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode the entire array, and print out the counts and the resulting bytes.
      PrintCountsAndBytes(myChars, u7)
      PrintCountsAndBytes(myChars, u8)
      PrintCountsAndBytes(myChars, u16LE)
      PrintCountsAndBytes(myChars, u16BE)
      PrintCountsAndBytes(myChars, u32)

   End Sub


   Public Shared Sub PrintCountsAndBytes(chars() As Char, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(chars)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(chars.Length)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the array of chars.
      Dim bytes As Byte() = enc.GetBytes(chars)

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
'System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

Açıklamalar

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, yönteminin dize sürümünü GetBytes çağırmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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

GetBytes(String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar.

public:
 virtual cli::array <System::Byte> ^ GetBytes(System::String ^ s);

public virtual byte[] GetBytes(string s);

abstract member GetBytes : string -> byte[]
override this.GetBytes : string -> byte[]

Public Overridable Function GetBytes (s As String) As Byte()

Parametreler

s

String

Kodlanması gereken karakterleri içeren dize.

Döndürülenler

Byte[]

Belirtilen karakter kümesini kodlama sonuçlarını içeren bayt dizisi.

Özel durumlar

ArgumentNullException

s, null'e eşittir.

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, dizedeki bir dizeyi veya aralığı kodlamak için gereken bayt sayısını belirler, karakterleri kodlar ve sonuçta elde edilen baytları görüntüler.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF";

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode the entire string, and print out the counts and the resulting bytes.
      Console.WriteLine( "Encoding the entire string:" );
      PrintCountsAndBytes( myStr, u7 );
      PrintCountsAndBytes( myStr, u8 );
      PrintCountsAndBytes( myStr, u16LE );
      PrintCountsAndBytes( myStr, u16BE );
      PrintCountsAndBytes( myStr, u32 );

      Console.WriteLine();

      // Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      Console.WriteLine( "Encoding the characters from index 4 through 6:" );
      PrintCountsAndBytes( myStr, 4, 3, u7 );
      PrintCountsAndBytes( myStr, 4, 3, u8 );
      PrintCountsAndBytes( myStr, 4, 3, u16LE );
      PrintCountsAndBytes( myStr, 4, 3, u16BE );
      PrintCountsAndBytes( myStr, 4, 3, u32 );
   }

   public static void PrintCountsAndBytes( String s, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( s );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( s.Length );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the entire string.
      byte[] bytes = enc.GetBytes( s );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintCountsAndBytes( String s, int index, int count, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( s.ToCharArray(), index, count );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( count );
      Console.Write( " {0,-3} :", iMBC );

      // Encode a range of characters in the string.
      byte[] bytes = new byte[iBC];
      enc.GetBytes( s, index, count, bytes, bytes.GetLowerBound(0) );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

Encoding the entire string:
System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

Encoding the characters from index 4 through 6:
System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&HD8FF) & ChrW(&HDCFF)

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode the entire string, and print out the counts and the resulting bytes.
      Console.WriteLine("Encoding the entire string:")
      PrintCountsAndBytes(myStr, u7)
      PrintCountsAndBytes(myStr, u8)
      PrintCountsAndBytes(myStr, u16LE)
      PrintCountsAndBytes(myStr, u16BE)
      PrintCountsAndBytes(myStr, u32)

      Console.WriteLine()

      ' Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      Console.WriteLine("Encoding the characters from index 4 through 6:")
      PrintCountsAndBytes(myStr, 4, 3, u7)
      PrintCountsAndBytes(myStr, 4, 3, u8)
      PrintCountsAndBytes(myStr, 4, 3, u16LE)
      PrintCountsAndBytes(myStr, 4, 3, u16BE)
      PrintCountsAndBytes(myStr, 4, 3, u32)

   End Sub


   Overloads Public Shared Sub PrintCountsAndBytes(s As String, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(s)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(s.Length)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the entire string.
      Dim bytes As Byte() = enc.GetBytes(s)

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Overloads Public Shared Sub PrintCountsAndBytes(s As String, index As Integer, count As Integer, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(s.ToCharArray(), index, count)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(count)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode a range of characters in the string.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      Dim bytes(iBC - 1) As Byte
      enc.GetBytes(s, index, count, bytes, bytes.GetLowerBound(0))

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'Encoding the entire string:
'System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
'System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00
'
'Encoding the characters from index 4 through 6:
'System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
'System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

Açıklamalar

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. Encoding.GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, dize sürümünü GetByteskullanmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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

GetBytes(Char[], Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar.

public:
 virtual cli::array <System::Byte> ^ GetBytes(cli::array <char> ^ chars, int index, int count);

public virtual byte[] GetBytes(char[] chars, int index, int count);

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

Public Overridable Function GetBytes (chars As Char(), index As Integer, count As Integer) As Byte()

Parametreler

chars

Char[]

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

index

Int32

Kodlanacak ilk karakterin dizini.

count

Int32

Kodlanacak karakter sayısı.

Döndürülenler

Byte[]

Belirtilen karakter kümesini kodlama sonuçlarını içeren bayt dizisi.

Özel durumlar

ArgumentNullException

chars, null'e eşittir.

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

-veya-

index ve count içinde charsgeçerli bir aralığı ifade etmeyin.

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 karakter dizisinden üç karakteri kodlamak için gereken bayt sayısını belirler, karakterleri kodlar ve sonuçta elde edilen baytları görüntüler.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' };

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      PrintCountsAndBytes( myChars, 4, 3, u7 );
      PrintCountsAndBytes( myChars, 4, 3, u8 );
      PrintCountsAndBytes( myChars, 4, 3, u16LE );
      PrintCountsAndBytes( myChars, 4, 3, u16BE );
      PrintCountsAndBytes( myChars, 4, 3, u32 );
   }

   public static void PrintCountsAndBytes( char[] chars, int index, int count, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( chars, index, count );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( count );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the array of chars.
      byte[] bytes = enc.GetBytes( chars, index, count );

      // The following is an alternative way to encode the array of chars:
      // byte[] bytes = new byte[iBC];
      // enc.GetBytes( chars, index, count, bytes, bytes.GetLowerBound(0) );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF) }

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      PrintCountsAndBytes(myChars, 4, 3, u7)
      PrintCountsAndBytes(myChars, 4, 3, u8)
      PrintCountsAndBytes(myChars, 4, 3, u16LE)
      PrintCountsAndBytes(myChars, 4, 3, u16BE)
      PrintCountsAndBytes(myChars, 4, 3, u32)

   End Sub


   Public Shared Sub PrintCountsAndBytes(chars() As Char, index As Integer, count As Integer, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(chars, index, count)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(count)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the array of chars.
      Dim bytes As Byte() = enc.GetBytes(chars, index, count)

      ' The following is an alternative way to encode the array of chars:
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      ' Dim bytes(iBC - 1) As Byte
      ' enc.GetBytes( chars, index, count, bytes, bytes.GetLowerBound(0) )

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
'System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

Açıklamalar

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. Encoding.GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, dize sürümünü GetByteskullanmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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

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

Önemli

Bu API, CLS uyumlu değildir.

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter işaretçisinde başlayan bir karakter kümesini belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.

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

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
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 dizisini yazmaya başlama konumuna yönelik bir işaretçi.

byteCount

Int32

Yazacak bayt sayısı üst sınırı.

Döndürülenler

Int32

parametresi tarafından bytes belirtilen konumda yazılan gerçek bayt sayısı.

Öznitelikler

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Özel durumlar

ArgumentNullException

chars, null'e eşittir.

-veya-

bytes, null'e eşittir.

ArgumentOutOfRangeException

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

ArgumentException

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

Elde edilen baytların depolanmasını gerektiren GetBytes dizi boyutunu tam olarak hesaplamak için yöntemini çağırın GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırın GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.

Dönüştürülecek veriler yalnızca sıralı bloklarda (akıştan okunan veriler gibi) kullanılabiliyorsa veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, sırasıyla veya yöntemi tarafından GetDecoder sağlanan veya GetEncoderEncoder nesnesini türetilmiş bir sınıfın kullanmanız Decoder gerekir.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, dize sürümünü GetByteskullanmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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

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

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini belirtilen bayt dizisine kodlar.

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

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

abstract member GetBytes : char[] * int * int * byte[] * int -> int

Public MustOverride 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 yazılan bytesgerçek bayt sayısı.

Özel durumlar

ArgumentNullException

chars, null'e eşittir.

-veya-

bytes, null'e eşittir.

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

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

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 karakter dizisinden üç karakteri kodlamak için gereken bayt sayısını belirler, karakterleri kodlar ve sonuçta elde edilen baytları görüntüler.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' };

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      PrintCountsAndBytes( myChars, 4, 3, u7 );
      PrintCountsAndBytes( myChars, 4, 3, u8 );
      PrintCountsAndBytes( myChars, 4, 3, u16LE );
      PrintCountsAndBytes( myChars, 4, 3, u16BE );
      PrintCountsAndBytes( myChars, 4, 3, u32 );
   }

   public static void PrintCountsAndBytes( char[] chars, int index, int count, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( chars, index, count );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( count );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the array of chars.
      byte[] bytes = enc.GetBytes( chars, index, count );

      // The following is an alternative way to encode the array of chars:
      // byte[] bytes = new byte[iBC];
      // enc.GetBytes( chars, index, count, bytes, bytes.GetLowerBound(0) );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF) }

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      PrintCountsAndBytes(myChars, 4, 3, u7)
      PrintCountsAndBytes(myChars, 4, 3, u8)
      PrintCountsAndBytes(myChars, 4, 3, u16LE)
      PrintCountsAndBytes(myChars, 4, 3, u16BE)
      PrintCountsAndBytes(myChars, 4, 3, u32)

   End Sub


   Public Shared Sub PrintCountsAndBytes(chars() As Char, index As Integer, count As Integer, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(chars, index, count)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(count)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the array of chars.
      Dim bytes As Byte() = enc.GetBytes(chars, index, count)

      ' The following is an alternative way to encode the array of chars:
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      ' Dim bytes(iBC - 1) As Byte
      ' enc.GetBytes( chars, index, count, bytes, bytes.GetLowerBound(0) )

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
'System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

Açıklamalar

Sonucun baytlarını depolamak için tarafından GetBytes gereken dizi boyutunu tam olarak hesaplamak için yöntemini çağırmanız GetByteCount gerekir. En büyük dizi boyutunu hesaplamak için yöntemini çağırın GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. Encoding.GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, dize sürümünü GetByteskullanmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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

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

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.

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

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

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

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

Parametreler

s

String

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

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 yazılan bytesgerçek bayt sayısı.

Özel durumlar

ArgumentNullException

s, null'e eşittir.

-veya-

bytes, null'e eşittir.

ArgumentOutOfRangeException

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

-veya-

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

-veya-

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

ArgumentException

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

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, dizedeki bir dizeyi veya aralığı kodlamak için gereken bayt sayısını belirler, karakterleri kodlar ve sonuçta elde edilen baytları görüntüler.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF";

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode the entire string, and print out the counts and the resulting bytes.
      Console.WriteLine( "Encoding the entire string:" );
      PrintCountsAndBytes( myStr, u7 );
      PrintCountsAndBytes( myStr, u8 );
      PrintCountsAndBytes( myStr, u16LE );
      PrintCountsAndBytes( myStr, u16BE );
      PrintCountsAndBytes( myStr, u32 );

      Console.WriteLine();

      // Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      Console.WriteLine( "Encoding the characters from index 4 through 6:" );
      PrintCountsAndBytes( myStr, 4, 3, u7 );
      PrintCountsAndBytes( myStr, 4, 3, u8 );
      PrintCountsAndBytes( myStr, 4, 3, u16LE );
      PrintCountsAndBytes( myStr, 4, 3, u16BE );
      PrintCountsAndBytes( myStr, 4, 3, u32 );
   }

   public static void PrintCountsAndBytes( String s, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( s );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( s.Length );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the entire string.
      byte[] bytes = enc.GetBytes( s );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintCountsAndBytes( String s, int index, int count, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( s.ToCharArray(), index, count );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( count );
      Console.Write( " {0,-3} :", iMBC );

      // Encode a range of characters in the string.
      byte[] bytes = new byte[iBC];
      enc.GetBytes( s, index, count, bytes, bytes.GetLowerBound(0) );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

Encoding the entire string:
System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

Encoding the characters from index 4 through 6:
System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&HD8FF) & ChrW(&HDCFF)

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode the entire string, and print out the counts and the resulting bytes.
      Console.WriteLine("Encoding the entire string:")
      PrintCountsAndBytes(myStr, u7)
      PrintCountsAndBytes(myStr, u8)
      PrintCountsAndBytes(myStr, u16LE)
      PrintCountsAndBytes(myStr, u16BE)
      PrintCountsAndBytes(myStr, u32)

      Console.WriteLine()

      ' Encode three characters starting at index 4, and print out the counts and the resulting bytes.
      Console.WriteLine("Encoding the characters from index 4 through 6:")
      PrintCountsAndBytes(myStr, 4, 3, u7)
      PrintCountsAndBytes(myStr, 4, 3, u8)
      PrintCountsAndBytes(myStr, 4, 3, u16LE)
      PrintCountsAndBytes(myStr, 4, 3, u16BE)
      PrintCountsAndBytes(myStr, 4, 3, u32)

   End Sub


   Overloads Public Shared Sub PrintCountsAndBytes(s As String, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(s)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(s.Length)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the entire string.
      Dim bytes As Byte() = enc.GetBytes(s)

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Overloads Public Shared Sub PrintCountsAndBytes(s As String, index As Integer, count As Integer, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(s.ToCharArray(), index, count)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(count)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode a range of characters in the string.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      Dim bytes(iBC - 1) As Byte
      enc.GetBytes(s, index, count, bytes, bytes.GetLowerBound(0))

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'Encoding the entire string:
'System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
'System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00
'
'Encoding the characters from index 4 through 6:
'System.Text.UTF7Encoding       : 10  11  :2B 41 37 4C 59 2F 39 7A 2F 2D
'System.Text.UTF8Encoding       : 6   12  :CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 6   8   :B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 6   8   :03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 8   16  :B2 03 00 00 FF FC 04 00

Açıklamalar

Sonucun baytlarını depolamak için tarafından GetBytes gereken dizi boyutunu tam olarak hesaplamak için yöntemini çağırmanız GetByteCount gerekir. En büyük dizi boyutunu hesaplamak için yöntemini çağırın GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir. Encoding.GetBytes yöntemi, tek bir giriş akışında birden çok dönüştürmeyi işleyen yöntemin Encoder.GetBytes aksine ayrı dönüştürmeler bekler.

ve'nin GetByteCountGetBytes çeşitli sürümleri desteklenir. Aşağıdakiler, bu yöntemlerin kullanımı için bazı programlama konularıdır:

• Uygulamanızın bir kod sayfasına birçok giriş karakteri kodlaması ve birden çok çağrı kullanarak karakterleri işlemesi gerekebilir. Bu durumda, kullanılan nesne tarafından Encoder kalıcı olan durumu hesaba katarak çağrılar arasında durumu korumanız gerekebilir. (Örneğin, vekil çiftleri içeren bir karakter dizisi yüksek vekille bitebilir. , Encoder aşağıdaki bir çağrının başında düşük bir vekille birleştirilebilmesi için bu yüksek vekili anımsar. Encoding durumu koruyamaz, bu nedenle karakter öğesine gönderilir EncoderFallback.)

• Uygulamanız dize girişlerini işleyecekse, dize sürümünü GetByteskullanmanız gerekir.

• öğesinin GetBytes(Char*, Int32, Byte*, Int32) Unicode karakter arabelleği sürümü, özellikle nesnesini kullanan Encoder veya var olan arabelleklere eklenen birden çok çağrıda bazı hızlı tekniklere izin verir. Ancak işaretçiler gerektiğinden bu yöntem sürümünün bazen güvenli olmadığını unutmayın.

• Uygulamanızın büyük miktarda veriyi dönüştürmesi gerekiyorsa çıkış arabelleği yeniden kullanmalıdır. Bu durumda bayt GetBytes dizilerini destekleyen sürüm en iyi seçenektir.

• yerine yöntemini GetByteCountkullanmayı Encoder.Convert göz önünde bulundurun. Dönüştürme yöntemi mümkün olduğunca çok veriyi dönüştürür ve çıkış arabelleği çok küçükse bir özel durum oluşturur. Bir akışın sürekli kodlaması için bu yöntem genellikle en iyi seçenektir.

Ayrıca bkz.

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