Encoding.GetString Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

mscorlib.dll

Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów do ciągu.

Przeciążenia

Nazwa	Opis
GetString(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do ciągu.
GetString(Byte*, Int32)	Po zastąpieniu w klasie pochodnej dekoduje określoną liczbę bajtów rozpoczynających się od określonego adresu do ciągu.
GetString(Byte[])	Po zastąpieniu w klasie pochodnej dekoduje wszystkie bajty w określonej tablicy bajtów do ciągu.

GetString(Byte[], Int32, Int32)

Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do ciągu.

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

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

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

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

Parametry

bytes

Byte[]

Tablica bajtów zawierająca sekwencję bajtów do dekodowania.

index

Int32

Indeks pierwszego bajtu do dekodowania.

count

Int32

Liczba bajtów do dekodowania.

Zwraca

String

Ciąg zawierający wyniki dekodowania określonej sekwencji bajtów.

Wyjątki

ArgumentException

Tablica bajtów zawiera nieprawidłowe punkty kodu Unicode.

ArgumentNullException

Parametr bytes ma wartość null.

ArgumentOutOfRangeException

index lub count jest mniejsza niż zero.

— lub —

index i count nie oznaczają prawidłowego zakresu w elem bytes.

DecoderFallbackException

Wystąpił powrót (aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET)

— i —

DecoderFallback jest ustawiony na DecoderExceptionFallback.

Przykłady

Poniższy przykład odczytuje ciąg zakodowany w formacie UTF-8 z pliku binarnego reprezentowanego FileStream przez obiekt. W przypadku plików, które są mniejsze niż 2048 bajtów, odczytuje zawartość całego pliku do tablicy bajtów i wywołuje GetString(Byte[], Int32, Int32) metodę do dekodowania. W przypadku większych plików odczytuje 2048 bajtów jednocześnie w tablicy bajtów, wywołuje Decoder.GetCharCount(Byte[], Int32, Int32) metodę w celu określenia, ile znaków znajduje się w tablicy, a następnie wywołuje Decoder.GetChars(Byte[], Int32, Int32, Char[], Int32) metodę do dekodowania.

using System;
using System.IO;
using System.Text;

public class Example
{
   const int MAX_BUFFER_SIZE = 2048;
   static Encoding enc8 = Encoding.UTF8;
   static byte[] bytes = new byte[MAX_BUFFER_SIZE]; 

   public static void Main()
   {
      FileStream fStream = new FileStream(@".\Utf8Example.txt", FileMode.Open);
      string contents = null;
      
      // If file size is small, read in a single operation.
      if (fStream.Length <= MAX_BUFFER_SIZE) {
         int bytesRead = fStream.Read(bytes, 0, bytes.Length);
         contents = enc8.GetString(bytes, 0, bytesRead);
      }   
      // If file size exceeds buffer size, perform multiple reads.
      else {
         contents = ReadFromBuffer(fStream);
      }
      fStream.Close();
      Console.WriteLine(contents);
   }

    private static string ReadFromBuffer(FileStream fStream)
    {
        string output = String.Empty;
        Decoder decoder8 = enc8.GetDecoder();
      
        while (fStream.Position < fStream.Length) {
           int nBytes = fStream.Read(bytes, 0, bytes.Length);
           int nChars = decoder8.GetCharCount(bytes, 0, nBytes);
           char[] chars = new char[nChars];
           nChars = decoder8.GetChars(bytes, 0, nBytes, chars, 0);
           output += new String(chars, 0, nChars);                                                     
        }
        return output;
    }   
}
// The example displays the following output:
//     This is a UTF-8-encoded file that contains primarily Latin text, although it
//     does list the first twelve letters of the Russian (Cyrillic) alphabet:
//     
//     А б в г д е ё ж з и й к
//     
//     The goal is to save this file, then open and decode it as a binary stream.

Imports System.IO
Imports System.Text

Module Example
   Const MAX_BUFFER_SIZE As Integer = 2048
   
   Dim enc8 As Encoding = Encoding.UTF8
   Dim bytes(MAX_BUFFER_SIZE -1) As Byte
      
   Public Sub Main()
      Dim fStream As New FileStream(".\Utf8Example.txt", FileMode.Open)
      Dim contents As String = Nothing
      
      ' If file size is small, read in a single operation.
      If fStream.Length <= MAX_BUFFER_SIZE Then
         
         Dim bytesRead As Integer = fStream.Read(bytes, 0, bytes.Length)
         contents = enc8.GetString(bytes, 0, bytesRead)
      ' If file size exceeds buffer size, perform multiple reads.
      Else
         contents = ReadFromBuffer(fStream)
      End If
      fStream.Close()
      Console.WriteLine(contents)
   End Sub   

    Private Function ReadFromBuffer(fStream As FileStream) As String
        Dim bytes(MAX_BUFFER_SIZE) As Byte
        Dim output As String = String.Empty
        Dim decoder8 As Decoder = enc8.GetDecoder()
      
        Do While fStream.Position < fStream.Length
           Dim nBytes As Integer = fStream.Read(bytes, 0, bytes.Length)
           Dim nChars As Integer = decoder8.GetCharCount(bytes, 0, nBytes)
           Dim chars(nChars - 1) As Char
           nChars = decoder8.GetChars(bytes, 0, nBytes, chars, 0)
           output += New String(chars, 0, nChars)                                                     
        Loop
        Return output
    End Function
End Module
' The example displays the following output:
'     This is a UTF-8-encoded file that contains primarily Latin text, although it
'     does list the first twelve letters of the Russian (Cyrillic) alphabet:
'     
'     А б в г д е ё ж з и й к
'     
'     The goal is to save this file, then open and decode it as a binary stream.

W przykładzie użyto następującego tekstu, który powinien zostać zapisany w zakodowanym pliku UTF-8 o nazwie Utf8Example.txt.

This is a UTF-8-encoded file that contains primarily Latin text, although it
does list the first twelve letters of the Russian (Cyrillic) alphabet:

А б в г д е ё ж з и й к

The goal is to save this file, then open and decode it as a binary stream.

Uwagi

Jeśli dane do przekonwertowania są dostępne tylko w blokach sekwencyjnych (takich jak dane odczytane ze strumienia) lub jeśli ilość danych jest tak duża, że należy ją podzielić na mniejsze bloki, należy użyć Decoder metody lub Encoder dostarczonej przez GetDecoder metodę lub GetEncoder metodę, odpowiednio, klasy pochodnej.

Zapoznaj się z sekcją Encoding.GetChars Uwagi w temacie referencyjnym, aby zapoznać się z omówieniem technik dekodowania i zagadnień.

Zobacz też

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

GetString(Byte*, Int32)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Po zastąpieniu w klasie pochodnej dekoduje określoną liczbę bajtów rozpoczynających się od określonego adresu do ciągu.

public:
 System::String ^ GetString(System::Byte* bytes, int byteCount);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public string GetString(byte* bytes, int byteCount);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetString : nativeptr<byte> * int -> string

Parametry

bytes

Byte*

Wskaźnik do tablicy bajtów.

byteCount

Int32

Liczba bajtów do dekodowania.

Zwraca

String

Ciąg zawierający wyniki dekodowania określonej sekwencji bajtów.

Atrybuty

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Wyjątki

ArgumentNullException

bytes jest wskaźnikiem o wartości null.

ArgumentOutOfRangeException

Parametr byteCount ma wartość niższą niż zero.

DecoderFallbackException

Wystąpił powrót (zobacz kodowanie Kodowanie .NET aby uzyskać pełne wyjaśnienie)

— i —

DecoderFallback jest ustawiony na DecoderExceptionFallback.

Uwagi

Metoda została zaprojektowana GetString pod kątem optymalizacji wydajności w przypadku natywnego wskaźnika do tablicy bajtów. Zamiast tworzyć zarządzaną tablicę bajtów, a następnie dekodować ją, można wywołać tę metodę bez konieczności tworzenia obiektów pośrednich.

Jeśli dane do przekonwertowania są dostępne tylko w blokach sekwencyjnych (takich jak dane odczytane ze strumienia) lub jeśli ilość danych jest tak duża, że należy ją podzielić na mniejsze bloki, należy użyć Decoder obiektu zwróconego przez GetDecoder metodę klasy pochodnej.

Zapoznaj się z sekcją Encoding.GetChars Uwagi w temacie referencyjnym, aby zapoznać się z omówieniem technik dekodowania i zagadnień.

Należy pamiętać, że dokładne zachowanie GetString metody dla określonej Encoding implementacji zależy od strategii rezerwowej zdefiniowanej dla tego Encoding obiektu. Aby uzyskać więcej informacji, zobacz sekcję "Wybieranie strategii powrotu" w temacie Kodowanie typu .NET.

Zobacz też

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

GetString(Byte[])

Po zastąpieniu w klasie pochodnej dekoduje wszystkie bajty w określonej tablicy bajtów do ciągu.

public:
 virtual System::String ^ GetString(cli::array <System::Byte> ^ bytes);

public virtual string GetString(byte[] bytes);

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

Public Overridable Function GetString (bytes As Byte()) As String

Parametry

bytes

Byte[]

Tablica bajtów zawierająca sekwencję bajtów do dekodowania.

Zwraca

String

Ciąg zawierający wyniki dekodowania określonej sekwencji bajtów.

Wyjątki

ArgumentException

Tablica bajtów zawiera nieprawidłowe punkty kodu Unicode.

ArgumentNullException

Parametr bytes ma wartość null.

DecoderFallbackException

Wystąpił powrót (aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET)

— i —

DecoderFallback jest ustawiony na DecoderExceptionFallback.

Przykłady

Poniższy przykład odczytuje ciąg zakodowany w formacie UTF-8 z pliku binarnego reprezentowanego FileStream przez obiekt. W przypadku plików, które są mniejsze niż 2048 bajtów, odczytuje zawartość całego pliku do tablicy bajtów i wywołuje GetString(Byte[]) metodę do dekodowania. W przypadku większych plików odczytuje 2048 bajtów jednocześnie w tablicy bajtów, wywołuje Decoder.GetCharCount(Byte[], Int32, Int32) metodę w celu określenia, ile znaków znajduje się w tablicy, a następnie wywołuje Decoder.GetChars(Byte[], Int32, Int32, Char[], Int32) metodę do dekodowania.

using System;
using System.IO;
using System.Text;

public class Example
{
   const int MAX_BUFFER_SIZE = 2048;
   static Encoding enc8 = Encoding.UTF8;

   public static void Main()
   {
      FileStream fStream = new FileStream(@".\Utf8Example.txt", FileMode.Open);
      string contents = null;
      
      // If file size is small, read in a single operation.
      if (fStream.Length <= MAX_BUFFER_SIZE) {
         Byte[] bytes = new Byte[fStream.Length];
         fStream.Read(bytes, 0, bytes.Length);
         contents = enc8.GetString(bytes);
      }
      // If file size exceeds buffer size, perform multiple reads.
      else {
         contents = ReadFromBuffer(fStream);
      }
      fStream.Close();
      Console.WriteLine(contents);
   }

   private static string ReadFromBuffer(FileStream fStream)
   {
        Byte[] bytes = new Byte[MAX_BUFFER_SIZE];
        string output = String.Empty;
        Decoder decoder8 = enc8.GetDecoder();
      
        while (fStream.Position < fStream.Length) {
           int nBytes = fStream.Read(bytes, 0, bytes.Length);
           int nChars = decoder8.GetCharCount(bytes, 0, nBytes);
           char[] chars = new char[nChars];
           nChars = decoder8.GetChars(bytes, 0, nBytes, chars, 0);
           output += new String(chars, 0, nChars);                                                     
        }
        return output;
    }
}
// The example displays the following output:
//     This is a UTF-8-encoded file that contains primarily Latin text, although it
//     does list the first twelve letters of the Russian (Cyrillic) alphabet:
//     
//     А б в г д е ё ж з и й к
//     
//     The goal is to save this file, then open and decode it as a binary stream.

Imports System.IO
Imports System.Text

Module Example
   Const MAX_BUFFER_SIZE As Integer = 2048
   
   Dim enc8 As Encoding = Encoding.UTF8
      
   Public Sub Main()
      Dim fStream As New FileStream(".\Utf8Example.txt", FileMode.Open)
      Dim contents As String = Nothing
      
      ' If file size is small, read in a single operation.
      If fStream.Length <= MAX_BUFFER_SIZE Then
         Dim bytes(CInt(fStream.Length) - 1) As Byte
         fStream.Read(bytes, 0, bytes.Length)
         contents = enc8.GetString(bytes)
      ' If file size exceeds buffer size, perform multiple reads.
      Else
         contents = ReadFromBuffer(fStream)
      End If
      fStream.Close()
      Console.WriteLine(contents)
   End Sub   

    Private Function ReadFromBuffer(fStream As FileStream) As String
        Dim bytes(MAX_BUFFER_SIZE) As Byte
        Dim output As String = String.Empty
        Dim decoder8 As Decoder = enc8.GetDecoder()
      
        Do While fStream.Position < fStream.Length
           Dim nBytes As Integer = fStream.Read(bytes, 0, bytes.Length)
           Dim nChars As Integer = decoder8.GetCharCount(bytes, 0, nBytes)
           Dim chars(nChars - 1) As Char
           nChars = decoder8.GetChars(bytes, 0, nBytes, chars, 0)
           output += New String(chars, 0, nChars)                                                     
        Loop
        Return output
    End Function
End Module
' The example displays the following output:
'     This is a UTF-8-encoded file that contains primarily Latin text, although it
'     does list the first twelve letters of the Russian (Cyrillic) alphabet:
'     
'     ? ? ? ? ? ? ? ? ? ? ? ?
'     
'     The goal is to save this file, then open and decode it as a binary stream.

W przykładzie użyto następującego tekstu, który powinien zostać zapisany w zakodowanym pliku UTF-8 o nazwie Utf8Example.txt.

This is a UTF-8-encoded file that contains primarily Latin text, although it
does list the first twelve letters of the Russian (Cyrillic) alphabet:

А б в г д е ё ж з и й к

The goal is to save this file, then open and decode it as a binary stream.

Uwagi

Jeśli dane do przekonwertowania są dostępne tylko w blokach sekwencyjnych (takich jak dane odczytane ze strumienia) lub jeśli ilość danych jest tak duża, że należy ją podzielić na mniejsze bloki, należy użyć Decoder obiektu zwróconego przez GetDecoder metodę klasy pochodnej.

Zapoznaj się z sekcją Encoding.GetChars Uwagi w temacie referencyjnym, aby zapoznać się z omówieniem technik dekodowania i zagadnień.

Należy pamiętać, że dokładne zachowanie GetString metody dla określonej Encoding implementacji zależy od strategii rezerwowej zdefiniowanej dla tego Encoding obiektu. Aby uzyskać więcej informacji, zobacz sekcję "Wybieranie strategii powrotu" w temacie Kodowanie typu .NET.

Zobacz też

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