UTF8Encoding.GetString(Byte[], Int32, Int32) Método

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

Parâmetros

Devoluções

A contendo String os resultados da decodificação da sequência especificada de bytes.

Atributos

ComVisibleAttribute

Exceções

Exemplos

O exemplo seguinte inicializa um array chamando o GetByteCount método para determinar exatamente quantos bytes são necessários para uma cadeia codificada e depois somando o tamanho da marca de ordem dos bytes (BOM). O exemplo chama então o GetPreamble método para armazenar a BOM no array antes de chamar o GetBytes método para armazenar os bytes codificados no array. O exemplo chama então o GetString método para decodificar a cadeia.

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...

Note-se que, neste caso, a cadeia decodificada difere da cadeia original, pois começa com uma marca de ordem de bytes de 16 bits U+FFFD. Isto significa que as duas cadeias se compararão como desiguais e, se a cadeia for produzida, a BOM será apresentada como o carácter de substituição "?". Para remover a lista de materiais no início da cadeia, pode chamar o String.TrimStart método.

Observações

Com a deteção de erros, uma sequência inválida faz com que este método crie uma ArgumentException exceção. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.

Se o intervalo de bytes a decodificar incluir a marca de ordem de bytes (BOM) e o array de bytes for devolvido por um método de tipo não conhecido pela BOM, o carácter U+FFFE é incluído no array de caracteres devolvido por este método. Podes removê-lo chamando o String.TrimStart método.

Os dados a converter, como dados lidos de um fluxo, podem estar disponíveis apenas em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, use o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

Ver também

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