UnicodeEncoding.GetString(Byte[], Int32, Int32) 方法

public:
 override System::String ^ GetString(cli::array <System::Byte> ^ bytes, int index, int count);

public override string GetString (byte[] bytes, int index, int count);

[System.Runtime.InteropServices.ComVisible(false)]
public override string GetString (byte[] bytes, int index, int count);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetString : byte[] * int * int -> string

Public Overrides Function GetString (bytes As Byte(), index As Integer, count As Integer) As String

参数

返回

包含指定字节序列解码结果的 String 对象。

属性

ComVisibleAttribute

例外

示例

以下示例通过调用 GetByteCount 方法来初始化数组，以确定编码字符串所需的字节数，然后将字节顺序标记的大小添加到 BOM) (。 然后，该示例调用 GetPreamble 方法将 BOM 存储到数组，然后调用 GetBytes 方法将编码的字节存储到数组。 然后，该示例调用 GetString 方法来解码字符串。

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      UTF8Encoding utf8 = new UTF8Encoding(true, true);

      String s = "It was the best of times, it was the worst of times...";

      // We need to dimension the array, since we'll populate it with 2 method calls.
      Byte[] bytes = new Byte[utf8.GetByteCount(s) + utf8.GetPreamble().Length];
      // Encode the string.
      Array.Copy(utf8.GetPreamble(), bytes, utf8.GetPreamble().Length);
      utf8.GetBytes(s, 0, s.Length, bytes, utf8.GetPreamble().Length);

      // Decode the byte array.
      String s2 = utf8.GetString(bytes, 0, bytes.Length);
      Console.WriteLine(s2);
   }
}
// The example displays the following output:
//        ?It was the best of times, it was the worst of times...

Imports System.Text

Module Example
   Public Sub Main()
      Dim utf8 As New UTF8Encoding(True, True)

      Dim s As String = "It was the best of times, it was the worst of times..."

      ' We need to dimension the array, since we'll populate it with 2 method calls.
      Dim bytes(utf8.GetByteCount(s) + utf8.GetPreamble().Length - 1) As Byte
      ' Encode the string.
      Array.Copy(utf8.GetPreamble(), bytes, utf8.GetPreamble().Length)
      utf8.GetBytes(s, 0, s.Length, bytes, utf8.GetPreamble().Length)

      ' Decode the byte array.
      Dim s2 As String = utf8.GetString(bytes, 0, bytes.Length)
      Console.WriteLine(s2)
   End Sub
End Module
' The example displays the following output:
'       ?It was the best of times, it was the worst of times...

请注意，在这种情况下，解码的字符串不同于原始字符串，因为它以 16 位字节顺序标记 U+FFFD 开头。 这意味着这两个字符串将比较为不相等，如果输出字符串，BOM 将显示为替换字符“？”。 若要删除的字符串的开始处的 BOM，可以调用String.TrimStart方法。

注解

使用错误检测时，无效序列会导致此方法引发 ArgumentException。 如果不进行错误检测，将忽略无效序列，并且不会引发异常。

如果要解码的字节范围包括 BOM) (字节顺序标记，并且字节数组是由非 BOM 感知类型的方法返回的，则字符 U+FFFE 包含在此方法返回的字符数组中。 可以通过调用 String.TrimStart 方法将其删除。

要转换的数据（例如从流读取的数据）可能仅在顺序块中可用。 在这种情况下，或者如果数据量太大，需要将其划分为较小的块，则应用程序应分别使用 Decoder 或 Encoder 方法提供的 GetDecoder 或 GetEncoder 对象。

适用于

另请参阅

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetDecoder()
• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)