UTF8Encoding.GetString(Byte[], Int32, Int32) Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Kaynak:

UTF8Encoding.cs

Bayt dizisinden dizeye bayt aralığının kodunu çözer.

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

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

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

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

Parametreler

bytes

Byte[]

Kod çözme bayt sırasını içeren bayt dizisi.

index

Int32

Kodu çözecek ilk bayt dizini.

count

Int32

Kodu çözecek bayt sayısı.

Döndürülenler

String

String Belirtilen bayt dizisinin kodunu çözmenin sonuçlarını içeren.

Özel durumlar

ArgumentNullException

bytes, null değeridir.

ArgumentOutOfRangeException

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

-veya-

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

ArgumentException

Hata algılama etkinleştirildi ve bytes geçersiz bayt dizisi içeriyor.

DecoderFallbackException

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

-Ve-

DecoderFallback olarak ayarlanır DecoderExceptionFallback.

Örnekler

Aşağıdaki örnek, kodlanmış bir dize için tam olarak kaç bayt gerektiğini belirlemek için yöntemini çağırarak GetByteCount ve ardından bayt sırası işaretinin (BOM) boyutunu ekleyerek bir dizi başlatır. Örnek daha sonra kodlanmış baytları diziye depolamak için yöntemini çağırmadan GetBytes önce bom'u diziye depolama yöntemini çağırırGetPreamble. Örnek daha sonra dizenin GetString kodunu çözmek için yöntemini çağırır.

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

Bu durumda, kodu çözülen dizenin özgün dizeden farklı olduğunu unutmayın çünkü 16 bit baytlık bir bayt sırası işaretiyle başlar U+FFFD. Başka bir deyişle, iki dize eşit değil olarak karşılaştırılır ve dize çıktı ise, ürün reçetesinin "?" değiştirme karakteri olarak görüntüleneceği anlamına gelir. Dizenin başındaki BOM'u kaldırmak için yöntemini çağırabilirsiniz String.TrimStart .

Açıklamalar

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.

Kodu çözülecek bayt aralığı bayt sırası işaretini (BOM) içeriyorsa ve bayt dizisi bom olmayan bir tür yöntemi tarafından döndürüldüyse, U+FFFE karakteri bu yöntem tarafından döndürülen karakter dizisine eklenir. yöntemini çağırarak String.TrimStart kaldırabilirsiniz.

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.

Ayrıca bkz.

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