Encoding.GetChars 方法

Source:

Encoding.cs

Source:

Encoding.cs

Source:

Encoding.cs

public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

参数

返回

写入 chars 的实际字符数。

例外

示例

下面的示例将字符串从一种编码转换为另一种编码。

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

下面的示例将字符串编码为一个字节数组，然后将一系列字节解码为字符数组。

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding( "utf-32" );
      Encoding u32BE = Encoding.GetEncoding( "utf-32BE" );

      // Use a string containing the following characters:
      //    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)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string using the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // Encode the string using the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts, decode eight bytes starting at index 0,
      // and print out the counts and the resulting bytes.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, 0, 8, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, 0, 8, u32LE );
   }

   public static void PrintCountsAndChars( byte[] bytes, int index, int count, Encoding enc )  {

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

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes, index, count );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( count );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars( bytes, index, count );

      // The following is an alternative way to decode the bytes:
      // char[] chars = new char[iCC];
      // enc.GetChars( bytes, index, count, chars, 0 );

      Console.WriteLine( chars );
   }
}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 2   6   :za
LE array with LE encoding : System.Text.UTF32Encoding : 2   6   :za

*/

注解

若要计算存储所生成的字符所需的确切数组大小 GetChars ，应使用 GetCharCount 方法。 若要计算最大数组大小，请使用 GetMaxCharCount 方法。 GetCharCount方法通常允许分配较少的内存，而 GetMaxCharCount 方法的执行速度通常更快。

GetChars(Byte[], Int32, Int32, Char[], Int32)从输入字节序列中获取字符。 Encoding.GetChars不同于 Decoder.GetChars ，因为 Encoding 需要离散转换，而 Decoder 为单个输入流上的多个传递设计。

如果要转换的数据仅在顺序块（如从流中读取的数据）中可用，或者如果数据量很大以致需要分为更小块，则应使用 DecoderEncoderGetDecoder 派生类的方法或方法提供的或 GetEncoder 。

GetCharCount方法确定多少个字符会导致对一个字节序列进行解码，并且该 GetChars 方法执行实际解码。 Encoding.GetChars方法需要分离转换，这与方法不同， Decoder.GetChars 后者处理单个输入流上的多个传递。

支持和的多个版本 GetCharCountGetChars 。 下面是有关使用这些方法的一些编程注意事项：

• 您的应用程序可能需要从代码页解码多个输入字节，并使用多个调用处理这些字节。 在这种情况下，您可能需要维护两次调用之间的状态，因为在分批处理时，字节序列可能会中断。 (例如，ISO-2022 班次序列的一部分可能会结束一次调用，并在下一 GetChars 次 GetChars 调用开始时继续。 Encoding.GetChars 将调用这些不完整序列的回退，但 Decoder 会记住下一次调用的这些序列。)

• 如果你的应用程序处理字符串输出，则 GetString 建议使用方法。 由于此方法必须检查字符串长度并分配一个缓冲区，因此它稍慢一些，但生成的 String 类型是首选的。

• 的字节版本 GetChars(Byte*, Int32, Char*, Int32) 允许一些快速的方法，尤其是对大缓冲区的多个调用。 但请记住，此方法版本有时不安全，因为指针是必需的。

• 如果你的应用程序必须转换大量数据，则应重新使用输出缓冲区。 在这种情况下， GetChars(Byte[], Int32, Int32, Char[], Int32) 支持输出字符缓冲区的版本是最佳选择。

• 请考虑使用 Decoder.Convert 方法而不是 GetCharCount 。 转换方法尽可能多地转换数据，如果输出缓冲区太小，则会引发异常。 对于流的连续解码，此方法通常是最佳选择。

另请参阅

• GetCharCount(Byte[])
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[])

Source:

Encoding.cs

Source:

Encoding.cs

Source:

Encoding.cs

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

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

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

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

参数

返回

在由 chars 参数指示的位置处写入的实际字符数。

属性

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

例外

注解

若要计算 GetChars 存储所生成的字符所需的确切数组大小，应使用 GetCharCount 方法。 若要计算最大数组大小，请使用 GetMaxCharCount 方法。 GetCharCount方法通常允许分配较少的内存，而 GetMaxCharCount 方法的执行速度通常更快。

Encoding.GetChars从输入字节序列中获取字符。 Encoding.GetChars不同于 Decoder.GetChars ，因为 Encoding 需要离散转换，而 Decoder 为单个输入流上的多个传递设计。

如果要转换的数据仅在 （如从流中读取的数据） 的顺序块中可用，或者如果数据量很大，它需要划分为较小的块，则应使用Decoder或Encoder提供对象GetDecoder或GetEncoder方法，分别的派生类。

GetCharCount方法确定多少个字符会导致对一个字节序列进行解码，并且该 GetChars 方法执行实际解码。 Encoding.GetChars方法需要分离转换，这与方法不同， Decoder.GetChars 后者处理单个输入流上的多个传递。

支持和的多个版本 GetCharCountGetChars 。 下面是有关使用这些方法的一些编程注意事项：

• 您的应用程序可能需要从代码页解码多个输入字节，并使用多个调用处理这些字节。 在这种情况下，您可能需要维护两次调用之间的状态，因为在分批处理时，字节序列可能会中断。 (例如，ISO-2022 班次序列的一部分可能会结束一次调用，并在下一 GetChars 次 GetChars 调用开始时继续。 Encoding.GetChars 将调用这些不完整序列的回退，但 Decoder 会记住下一次调用的这些序列。)

• 如果你的应用程序处理字符串输出，则 GetString 建议使用方法。 由于此方法必须检查字符串长度并分配一个缓冲区，因此它稍慢一些，但生成的 String 类型是首选的。

• 的字节版本 GetChars(Byte*, Int32, Char*, Int32) 允许一些快速的方法，尤其是对大缓冲区的多个调用。 但请记住，此方法版本有时不安全，因为指针是必需的。

• 如果你的应用程序必须转换大量数据，则应重新使用输出缓冲区。 在这种情况下， GetChars(Byte[], Int32, Int32, Char[], Int32) 支持输出字符缓冲区的版本是最佳选择。

• 请考虑使用 Decoder.Convert 方法而不是 GetCharCount 。 转换方法尽可能多地转换数据，如果输出缓冲区太小，则会引发异常。 对于流的连续解码，此方法通常是最佳选择。

另请参阅

• GetCharCount(Byte[])
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[])

Source:

Encoding.cs

Source:

Encoding.cs

Source:

Encoding.cs

public virtual char[] GetChars (byte[] bytes, int index, int count);

参数

返回

一个字节数组，包含对指定的字节序列进行解码的结果。

例外

示例

下面的示例将字符串编码为一个字节数组，然后将一系列字节解码为字符数组。

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding( "utf-32" );
      Encoding u32BE = Encoding.GetEncoding( "utf-32BE" );

      // Use a string containing the following characters:
      //    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)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string using the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // Encode the string using the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts, decode eight bytes starting at index 0,
      // and print out the counts and the resulting bytes.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, 0, 8, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, 0, 8, u32LE );
   }

   public static void PrintCountsAndChars( byte[] bytes, int index, int count, Encoding enc )  {

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

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes, index, count );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( count );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars( bytes, index, count );

      // The following is an alternative way to decode the bytes:
      // char[] chars = new char[iCC];
      // enc.GetChars( bytes, index, count, chars, 0 );

      Console.WriteLine( chars );
   }
}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 2   6   :za
LE array with LE encoding : System.Text.UTF32Encoding : 2   6   :za

*/

注解

Encoding.GetChars从输入字节序列中获取字符。 Encoding.GetChars不同于 Decoder.GetChars ，因为 Encoding 需要离散转换，而 Decoder 为单个输入流上的多个传递设计。

如果要转换的数据仅在顺序块（如从流中读取的数据）中可用，或者如果数据量很大以致需要分为更小块，则应使用 DecoderEncoderGetDecoder 派生类的方法或方法提供的或 GetEncoder 。

GetCharCount方法确定多少个字符会导致对一个字节序列进行解码，并且该 GetChars 方法执行实际解码。 Encoding.GetChars方法需要分离转换，这与方法不同， Decoder.GetChars 后者处理单个输入流上的多个传递。

支持和的多个版本 GetCharCountGetChars 。 下面是有关使用这些方法的一些编程注意事项：

• 您的应用程序可能需要从代码页解码多个输入字节，并使用多个调用处理这些字节。 在这种情况下，您可能需要维护两次调用之间的状态，因为在分批处理时，字节序列可能会中断。 (例如，ISO-2022 班次序列的一部分可能会结束一次调用，并在下一次GetChars调用开始时继续。Encoding.GetChars将调用这些不完整序列的回退，但Decoder会记住下一GetChars次调用的这些序列。)

• 如果你的应用程序处理字符串输出，则建议使用 GetString 方法。 由于此方法必须检查字符串长度并分配一个缓冲区，因此它稍慢一些，但生成的 String 类型是首选的。

• 的字节版本 GetChars(Byte*, Int32, Char*, Int32) 允许一些快速的方法，尤其是对大缓冲区的多个调用。 但请记住，此方法版本有时不安全，因为指针是必需的。

• 如果你的应用程序必须转换大量数据，则应重新使用输出缓冲区。 在这种情况下， GetChars(Byte[], Int32, Int32, Char[], Int32) 支持输出字符缓冲区的版本是最佳选择。

• 请考虑使用 Decoder.Convert 方法而不是 GetCharCount 。 转换方法尽可能多地转换数据，如果输出缓冲区太小，则会引发异常。 对于流的连续解码，此方法通常是最佳选择。

另请参阅

• GetCharCount(Byte[])
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[])

Source:

Encoding.cs

Source:

Encoding.cs

Source:

Encoding.cs

public virtual int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars);

参数

返回

在由 chars 参数指示的范围处写入的实际字符数。

注解

Encoding.GetChars从输入字节跨度中获取字符。 Encoding.GetChars不同于 Decoder.GetChars ，因为 Encoding 需要离散转换，而 Decoder 为单个输入流上的多个传递设计。

如果要转换的数据仅在顺序块（如从流中读取的数据）中可用，或者如果数据量很大以致需要分为更小块，则应使用 DecoderEncoderGetDecoder 派生类的方法或方法提供的或 GetEncoder 。

GetCharCount方法确定多少个字符会导致对一个字节序列进行解码，并且该 GetChars 方法执行实际解码。 Encoding.GetChars方法需要分离转换，这与方法不同， Decoder.GetChars 后者处理单个输入流上的多个传递。

支持和的多个版本 GetCharCountGetChars 。 下面是有关使用这些方法的一些编程注意事项：

• 您的应用程序可能需要从代码页解码多个输入字节，并使用多个调用处理这些字节。 在这种情况下，您可能需要维护两次调用之间的状态，因为在分批处理时，字节序列可能会中断。 (例如，ISO-2022 班次序列的一部分可能会结束一次调用，并在下一次GetChars调用开始时继续。Encoding.GetChars将调用这些不完整序列的回退，但Decoder会记住下一GetChars次调用的这些序列。)

• 如果你的应用程序处理字符串输出，则建议使用 GetString 方法。 由于此方法必须检查字符串长度并分配一个缓冲区，因此它稍慢一些，但生成的 String 类型是首选的。

• 的字节版本 GetChars(Byte*, Int32, Char*, Int32) 允许一些快速的方法，尤其是对大缓冲区的多个调用。 但请记住，此方法版本有时不安全，因为指针是必需的。

• 如果你的应用程序必须转换大量数据，则应重新使用输出缓冲区。 在这种情况下， GetChars(Byte[], Int32, Int32, Char[], Int32) 支持输出字符缓冲区的版本是最佳选择。

• 请考虑使用 Decoder.Convert 方法而不是 GetCharCount 。 转换方法尽可能多地转换数据，如果输出缓冲区太小，则会引发异常。 对于流的连续解码，此方法通常是最佳选择。

Source:

Encoding.cs

Source:

Encoding.cs

Source:

Encoding.cs

public virtual char[] GetChars (byte[] bytes);

参数

返回

一个字节数组，包含对指定的字节序列进行解码的结果。

例外

示例

下面的示例将字符串编码为一个字节数组，然后将这些字节解码为一个字符数组。

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding( "utf-32" );
      Encoding u32BE = Encoding.GetEncoding( "utf-32BE" );

      // Use a string containing the following characters:
      //    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)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string using the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // Encode the string using the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts, and decode the byte arrays.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, u32LE );
   }

   public static void PrintCountsAndChars( byte[] bytes, Encoding enc )  {

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

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( bytes.Length );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars( bytes );
      Console.WriteLine( chars );
   }
}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ
LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ

*/

注解

Encoding.GetChars从输入字节序列中获取字符。 Encoding.GetChars不同于 Decoder.GetChars ，因为 Encoding 需要离散转换，而 Decoder 为单个输入流上的多个传递设计。

如果要转换的数据仅在顺序块（如从流中读取的数据）中可用，或者如果数据量很大以致需要分为更小块，则应使用 DecoderEncoderGetDecoder 派生类的方法或方法提供的或 GetEncoder 。

GetCharCount方法确定多少个字符会导致对一个字节序列进行解码，并且该 GetChars 方法执行实际解码。 Encoding.GetChars方法需要分离转换，这与方法不同， Decoder.GetChars 后者处理单个输入流上的多个传递。

支持和的多个版本 GetCharCountGetChars 。 下面是有关使用这些方法的一些编程注意事项：

• 您的应用程序可能需要从代码页解码多个输入字节，并使用多个调用处理这些字节。 在这种情况下，您可能需要维护两次调用之间的状态，因为在分批处理时，字节序列可能会中断。 (例如，ISO-2022 班次序列的一部分可能会结束一次调用，并在下一次GetChars调用开始时继续。Encoding.GetChars将调用这些不完整序列的回退，但Decoder会记住下一GetChars次调用的这些序列。)

• 如果你的应用程序处理字符串输出，则建议使用 GetString 方法。 由于此方法必须检查字符串长度并分配一个缓冲区，因此它稍慢一些，但生成的 String 类型是首选的。

• 的字节版本 GetChars(Byte*, Int32, Char*, Int32) 允许一些快速的方法，尤其是对大缓冲区的多个调用。 但请记住，此方法版本有时不安全，因为指针是必需的。

• 如果你的应用程序必须转换大量数据，则应重新使用输出缓冲区。 在这种情况下， GetChars(Byte[], Int32, Int32, Char[], Int32) 支持输出字符缓冲区的版本是最佳选择。

• 请考虑使用 Decoder.Convert 方法而不是 GetCharCount 。 转换方法尽可能多地转换数据，如果输出缓冲区太小，则会引发异常。 对于流的连续解码，此方法通常是最佳选择。

另请参阅

• GetCharCount(Byte[])
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[])