UnicodeEncoding Klasa

Definicja

Reprezentuje kodowanie UTF-16 znaków Unicode.Represents a UTF-16 encoding of Unicode characters.

public ref class UnicodeEncoding : System::Text::Encoding
public class UnicodeEncoding : System.Text.Encoding
[System.Serializable]
public class UnicodeEncoding : System.Text.Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UnicodeEncoding : System.Text.Encoding
type UnicodeEncoding = class
    inherit Encoding
[<System.Serializable>]
type UnicodeEncoding = class
    inherit Encoding
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UnicodeEncoding = class
    inherit Encoding
Public Class UnicodeEncoding
Inherits Encoding
Dziedziczenie
UnicodeEncoding
Atrybuty

Przykłady

Poniższy przykład ilustruje sposób kodowania ciągu znaków Unicode w tablicy bajtowej przy użyciu UnicodeEncoding obiektu.The following example demonstrates how to encode a string of Unicode characters into a byte array by using a UnicodeEncoding object. Tablica bajtów jest zdekodowana do ciągu, aby udowodnić, że dane nie są tracone.The byte array is decoded into a string to demonstrate that there is no loss of data.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // The encoding.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a String* that contains Unicode characters.
   String^ unicodeString = L"This Unicode string contains two characters with codes outside the traditional ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the String*.
   array<Byte>^encodedBytes = unicode->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
   
   // Decode bytes back to String*.
   // Notice Pi and Sigma characters are still present.
   String^ decodedString = unicode->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}
using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        // The encoding.
        UnicodeEncoding unicode = new UnicodeEncoding();
        
        // Create a string that contains Unicode characters.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the traditional ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = unicode.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        ' The encoding.
        Dim uni As New UnicodeEncoding()
        
        ' Create a string that contains Unicode characters.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the traditional ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = uni.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = uni.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

Poniższy przykład używa tego samego ciągu co poprzedni, z tą różnicą, że zapisuje zakodowane bajty do pliku i prefiksy strumienia bajtów ze znacznikiem kolejności bajtów (BOM).The following example uses the same string as the previous one, except that it writes the encoded bytes to a file and prefixes the byte stream with a byte order mark (BOM). Następnie odczytuje plik na dwa różne sposoby: jako plik tekstowy przy użyciu StreamReader obiektu oraz jako plik binarny.It then reads the file in two different ways: as a text file by using a StreamReader object; and as a binary file. Zgodnie z oczekiwaniami, żaden nowo odczytany ciąg nie obejmuje BOM.As you would expect, neither newly-read string includes the BOM.

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

public class Example
{
   public static void Main()
   {
        // Create a UTF-16 encoding that supports a BOM.
        Encoding unicode = new UnicodeEncoding();

        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This Unicode string has 2 characters outside the " +
            "ASCII range: \n" +
            "Pi (\u03A0)), and Sigma (\u03A3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);
        Console.WriteLine();

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine("The encoded string has {0} bytes.\n",
                          encodedBytes.Length);

        // Write the bytes to a file with a BOM.
        var fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Create);
        Byte[] bom = unicode.GetPreamble();
        fs.Write(bom, 0, bom.Length);
        fs.Write(encodedBytes, 0, encodedBytes.Length);
        Console.WriteLine("Wrote {0} bytes to the file.\n", fs.Length);
        fs.Close();

        // Open the file using StreamReader.
        var sr = new StreamReader(@".\UTF8Encoding.txt");
        String newString = sr.ReadToEnd();
        sr.Close();
        Console.WriteLine("String read using StreamReader:");
        Console.WriteLine(newString);
        Console.WriteLine();

        // Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Open);
        Byte[] bytes = new Byte[fs.Length];
        fs.Read(bytes, 0, (int)fs.Length);
        fs.Close();

        String decodedString = unicode.GetString(bytes);
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
   }
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    The encoded string has 172 bytes.
//
//    Wrote 174 bytes to the file.
//
//    String read using StreamReader:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Decoded bytes:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
Imports System.IO
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' Create a UTF-16 encoding that supports a BOM.
        Dim unicode As New UnicodeEncoding()
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim unicodeString As String = _
            "This Unicode string has 2 characters outside the " &
            "ASCII range: " & vbCrLf &
            "Pi (" & ChrW(&h03A0) & "), and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        Console.WriteLine()
        
        ' Encode the string.
        Dim encodedBytes As Byte() = unicode.GetBytes(unicodeString)
        Console.WriteLine("The encoded string has {0} bytes.",
                          encodedBytes.Length)
        Console.WriteLine()
        
        ' Write the bytes to a file with a BOM.
        Dim fs As New FileStream(".\UnicodeEncoding.txt", FileMode.Create)
        Dim bom() As Byte = unicode.GetPreamble()
        fs.Write(bom, 0, bom.Length)
        fs.Write(encodedBytes, 0, encodedBytes.Length)
        Console.WriteLine("Wrote {0} bytes to the file.", fs.Length)
        fs.Close()
        Console.WriteLine()
        
        ' Open the file using StreamReader.
        Dim sr As New StreamReader(".\UnicodeEncoding.txt")
        Dim newString As String = sr.ReadToEnd()
        sr.Close()
        Console.WriteLine("String read using StreamReader:")
        Console.WriteLine(newString)
        Console.WriteLine()
        
        ' Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(".\UnicodeEncoding.txt", FileMode.Open)
        Dim bytes(fs.Length - 1) As Byte
        fs.Read(bytes, 0, fs.Length)
        fs.Close()

        Dim decodedString As String = unicode.GetString(bytes)
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    The encoded string has 172 bytes.
'
'    Wrote 174 bytes to the file.
'
'    String read using StreamReader:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Decoded bytes:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).

Uwagi

Kodowanie jest procesem przekształcania zestawu znaków Unicode w sekwencję bajtów.Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. Dekodowanie jest procesem przekształcania sekwencji zakodowanych bajtów na zestaw znaków Unicode.Decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters.

Standard Unicode przypisuje punkt kodu (numer) do każdego znaku w każdym obsługiwanym skrypcie.The Unicode Standard assigns a code point (a number) to each character in every supported script. Format przekształcenia Unicode (UTF) jest sposobem kodowania tego punktu kodu.A Unicode Transformation Format (UTF) is a way to encode that code point. W standardzie Unicode jest stosowany następujący UTFs:The Unicode Standard uses the following UTFs:

  • UTF-8, który reprezentuje każdy punkt kodu jako sekwencję od 1 do 4 bajtów.UTF-8, which represents each code point as a sequence of one to four bytes.

  • UTF-16, który reprezentuje każdy punkt kodu jako sekwencję od 1 do 2 16-bitowych liczb całkowitych.UTF-16, which represents each code point as a sequence of one to two 16-bit integers.

  • UTF-32, który reprezentuje każdy punkt kodu jako 32-bitową liczbę całkowitą.UTF-32, which represents each code point as a 32-bit integer.

Aby uzyskać więcej informacji na temat UTFs i innych kodowań obsługiwanych przez System.Text program, zobacz kodowanie znaków w .NET Framework.For more information about the UTFs and other encodings supported by System.Text, see Character Encoding in the .NET Framework.

UnicodeEncodingKlasa reprezentuje kodowanie UTF-16.The UnicodeEncoding class represents a UTF-16 encoding. Koder może korzystać z big endian kolejności bajtów (najpierw z najbardziej znaczącym bajtem) lub z kolejnością bajtów little endian (najpierw znaczący bajt).The encoder can use either big endian byte order (most significant byte first) or little endian byte order (least significant byte first). Na przykład Wielka litera A (punkt kodu U + 0041) jest serializowana w następujący sposób (w formacie szesnastkowym):For example, the Latin Capital Letter A (code point U+0041) is serialized as follows (in hexadecimal):

  • Kolejność bajtów big endian: 00 00 00 41Big endian byte order: 00 00 00 41

  • Mała kolejność bajtów endian: 41 00 00 00Little endian byte order: 41 00 00 00

Zwykle bardziej wydajne jest przechowywanie znaków Unicode przy użyciu kolejności bajtów natywnych określonej platformy.It is generally more efficient to store Unicode characters using the native byte order of a particular platform. Na przykład lepiej jest używać kolejności bajtów little endian na platformach little endian, takich jak komputery Intel.For example, it is better to use the little endian byte order on little endian platforms, such as Intel computers. UnicodeEncodingKlasa odnosi się do stron kodowych systemu Windows 1200 (kolejność bajtów little endian) i 1201 (kolejność bajtów big endian).The UnicodeEncoding class corresponds to the Windows code pages 1200 (little endian byte order) and 1201 (big endian byte order). Możesz określić "przydziały" dla określonej architektury, wywołując BitConverter.IsLittleEndian metodę.You can determine the "endianness" of a particular architecture by calling the BitConverter.IsLittleEndian method.

Opcjonalnie UnicodeEncoding obiekt zawiera znacznik kolejności bajtów (BOM), który jest tablicą bajtów, które mogą być poprzedzone sekwencją bajtów w wyniku procesu kodowania.Optionally, the UnicodeEncoding object provides a byte order mark (BOM), which is an array of bytes that can be prefixed to the sequence of bytes resulting from the encoding process. Jeśli Preambuła zawiera znacznik kolejności bajtów (BOM), pomaga dekoderowi określić kolejność bajtów i format transformacji lub UTF.If the preamble contains a byte order mark (BOM), it helps the decoder determine the byte order and the transformation format or UTF.

Jeśli UnicodeEncoding wystąpienie jest skonfigurowane do dostarczania BOM, można je pobrać, wywołując GetPreamble metodę; w przeciwnym razie metoda zwraca pustą tablicę.If the UnicodeEncoding instance is configured to provide a BOM, you can retrieve it by calling the GetPreamble method; otherwise, the method returns an empty array. Należy pamiętać, że nawet jeśli UnicodeEncoding dla obiektu jest skonfigurowany do obsługi BOM, należy uwzględnić BOM na początku strumienia zakodowanych bajtów, zgodnie z potrzebami, metody kodowania klasy nie są UnicodeEncoding automatycznie.Note that, even if a UnicodeEncoding object is configured for BOM support, you must include the BOM at the beginning of the encoded byte stream as appropriate; the encoding methods of the UnicodeEncoding class do not do this automatically.

Przestroga

Aby włączyć wykrywanie błędów i uczynić wystąpienie klasy bardziej bezpieczne, należy utworzyć wystąpienie UnicodeEncoding obiektu przez wywołanie UnicodeEncoding(Boolean, Boolean, Boolean) konstruktora i ustawienie jego throwOnInvalidBytes argumentu na true .To enable error detection and to make the class instance more secure, you should instantiate a UnicodeEncoding object by calling the UnicodeEncoding(Boolean, Boolean, Boolean) constructor and setting its throwOnInvalidBytes argument to true. W przypadku wykrywania błędów Metoda, która wykrywa nieprawidłową sekwencję znaków lub bajtów zgłasza ArgumentException .With error detection, a method that detects an invalid sequence of characters or bytes throws a ArgumentException. Bez wykrycia błędów nie jest zgłaszany żaden wyjątek, a Nieprawidłowa sekwencja jest zwykle ignorowana.Without error detection, no exception is thrown, and the invalid sequence is generally ignored.

Można utworzyć wystąpienie UnicodeEncoding obiektu na wiele sposobów, w zależności od tego, czy chcesz udostępnić znacznik kolejności bajtów (BOM), czy ma być używane kodowanie big-endian czy little-endian, oraz czy chcesz włączyć wykrywanie błędów.You can instantiate a UnicodeEncoding object in a number of ways, depending on whether you want to it to provide a byte order mark (BOM), whether you want big-endian or little-endian encoding, and whether you want to enable error detection. Poniższa tabela zawiera listę UnicodeEncoding konstruktorów i Encoding właściwości, które zwracają UnicodeEncoding obiekt.The following table lists the UnicodeEncoding constructors and the Encoding properties that return a UnicodeEncoding object.

CzłonekMember EndianEndianness BOMBOM Wykrywanie błędówError detection
BigEndianUnicode Big-endianBig-endian TakYes Nie (alternatywa zamienna)No (Replacement fallback)
Encoding.Unicode Little-endianLittle-endian TakYes Nie (alternatywa zamienna)No (Replacement fallback)
UnicodeEncoding.UnicodeEncoding() Little-endianLittle-endian TakYes Nie (alternatywa zamienna)No (Replacement fallback)
UnicodeEncoding(Boolean, Boolean) KonfigurowalneConfigurable KonfigurowalneConfigurable Nie (alternatywa zamienna)No (Replacement fallback)
UnicodeEncoding.UnicodeEncoding(Boolean, Boolean, Boolean) KonfigurowalneConfigurable KonfigurowalneConfigurable KonfigurowalneConfigurable

GetByteCountMetoda określa, ile bajtów powoduje kodowanie zestawu znaków Unicode, a GetBytes Metoda wykonuje rzeczywiste kodowanie.The GetByteCount method determines how many bytes result in encoding a set of Unicode characters, and the GetBytes method performs the actual encoding.

Podobnie GetCharCount Metoda określa, ile znaków powoduje dekodowanie sekwencji bajtów, a GetChars GetString metody i wykonuje rzeczywiste dekodowanie.Likewise, the GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars and GetString methods perform the actual decoding.

Dla kodera lub dekodera, który może zapisywać informacje o stanie podczas kodowania lub dekodowania danych obejmujących wiele bloków (takich jak ciąg znaków 1 000 000, który jest zakodowany w segmentach znaków 100 000), GetEncoder należy GetDecoder odpowiednio użyć właściwości i.For an encoder or decoder that is able to save state information when encoding or decoding data that spans multiple blocks (such as string of 1 million characters that is encoded in 100,000-character segments), use the GetEncoder and GetDecoder properties, respectively.

Konstruktory

UnicodeEncoding()

Inicjuje nowe wystąpienie klasy UnicodeEncoding.Initializes a new instance of the UnicodeEncoding class.

UnicodeEncoding(Boolean, Boolean)

Inicjuje nowe wystąpienie klasy UnicodeEncoding.Initializes a new instance of the UnicodeEncoding class. Parametry określają, czy należy używać kolejności bajtów big endian i czy GetPreamble() Metoda zwraca znacznik kolejności bajtów Unicode.Parameters specify whether to use the big endian byte order and whether the GetPreamble() method returns a Unicode byte order mark.

UnicodeEncoding(Boolean, Boolean, Boolean)

Inicjuje nowe wystąpienie klasy UnicodeEncoding.Initializes a new instance of the UnicodeEncoding class. Parametry określają, czy ma być używana kolejność bajtów big endian, czy ma być podany znacznik kolejności bajtów Unicode, oraz czy zgłaszać wyjątek, gdy zostanie wykryte nieprawidłowe kodowanie.Parameters specify whether to use the big endian byte order, whether to provide a Unicode byte order mark, and whether to throw an exception when an invalid encoding is detected.

Pola

CharSize

Reprezentuje rozmiar znaku Unicode w bajtach.Represents the Unicode character size in bytes. To pole jest stałą.This field is a constant.

Właściwości

BodyName

Gdy jest zastępowany w klasie pochodnej, pobiera nazwę bieżącego kodowania, który może być używany z tagami treści agenta poczty.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent body tags.

(Odziedziczone po Encoding)
CodePage

Gdy jest zastępowany w klasie pochodnej, pobiera identyfikator strony kodowej bieżącego Encoding .When overridden in a derived class, gets the code page identifier of the current Encoding.

(Odziedziczone po Encoding)
DecoderFallback

Pobiera lub ustawia DecoderFallback obiekt dla bieżącego Encoding obiektu.Gets or sets the DecoderFallback object for the current Encoding object.

(Odziedziczone po Encoding)
EncoderFallback

Pobiera lub ustawia EncoderFallback obiekt dla bieżącego Encoding obiektu.Gets or sets the EncoderFallback object for the current Encoding object.

(Odziedziczone po Encoding)
EncodingName

Gdy jest zastępowany w klasie pochodnej, Pobiera opis bieżącego kodowania przez człowieka.When overridden in a derived class, gets the human-readable description of the current encoding.

(Odziedziczone po Encoding)
HeaderName

Gdy jest zastępowany w klasie pochodnej, pobiera nazwę bieżącego kodowania, który może być używany z tagami nagłówka agenta poczty.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent header tags.

(Odziedziczone po Encoding)
IsBrowserDisplay

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do wyświetlania zawartości.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for displaying content.

(Odziedziczone po Encoding)
IsBrowserSave

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do zapisywania zawartości.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for saving content.

(Odziedziczone po Encoding)
IsMailNewsDisplay

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty e-mail i wiadomości do wyświetlania zawartości.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for displaying content.

(Odziedziczone po Encoding)
IsMailNewsSave

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty e-mail i wiadomości do zapisywania zawartości.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for saving content.

(Odziedziczone po Encoding)
IsReadOnly

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie jest tylko do odczytu.When overridden in a derived class, gets a value indicating whether the current encoding is read-only.

(Odziedziczone po Encoding)
IsSingleByte

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie używa jednobajtowych punktów kodowych.When overridden in a derived class, gets a value indicating whether the current encoding uses single-byte code points.

(Odziedziczone po Encoding)
Preamble

Pobiera znacznik kolejności bajtów Unicode zakodowany w formacie UTF-16, jeśli ten obiekt jest skonfigurowany do jego dostarczania.Gets a Unicode byte order mark encoded in UTF-16 format, if this object is configured to supply one.

Preamble

Gdy jest zastępowany w klasie pochodnej, zwraca zakres zawierający sekwencję bajtów, która określa używane kodowanie.When overridden in a derived class, returns a span containing the sequence of bytes that specifies the encoding used.

(Odziedziczone po Encoding)
WebName

Gdy jest zastępowany w klasie pochodnej, pobiera nazwę zarejestrowanej przez organizację IANA (Internet Assigned Numbers Authority) dla bieżącego kodowania.When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.

(Odziedziczone po Encoding)
WindowsCodePage

Gdy jest zastępowany w klasie pochodnej, pobiera stronę kodową systemu operacyjnego Windows, która najlepiej odpowiada bieżącemu kodowaniu.When overridden in a derived class, gets the Windows operating system code page that most closely corresponds to the current encoding.

(Odziedziczone po Encoding)

Metody

Clone()

Gdy jest zastępowany w klasie pochodnej, tworzy skróconą kopię bieżącego Encoding obiektu.When overridden in a derived class, creates a shallow copy of the current Encoding object.

(Odziedziczone po Encoding)
Equals(Object)

Określa, czy określony element Object jest równy bieżącemu UnicodeEncoding obiektowi.Determines whether the specified Object is equal to the current UnicodeEncoding object.

GetByteCount(Char*, Int32)

Oblicza liczbę bajtów wytwarzanych przez zakodowanie zestawu znaków, zaczynając od określonego wskaźnika znakowego.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char*, Int32)

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę bajtów wytwarzanych przez zakodowanie zestawu znaków, zaczynając od określonego wskaźnika znakowego.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

(Odziedziczone po Encoding)
GetByteCount(Char[])

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę bajtów generowanych przez kodowanie wszystkich znaków w określonej tablicy znaków.When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.

(Odziedziczone po Encoding)
GetByteCount(Char[], Int32, Int32)

Oblicza liczbę bajtów wytwarzanych przez zakodowanie zestawu znaków z określonej tablicy znaków.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(ReadOnlySpan<Char>)

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę bajtów wytwarzanych przez zakodowanie znaków w określonym zakresie znaków.When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified character span.

(Odziedziczone po Encoding)
GetByteCount(String)

Oblicza liczbę bajtów wytwarzanych przez zakodowanie znaków w określonym ciągu.Calculates the number of bytes produced by encoding the characters in the specified string.

GetByteCount(String, Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę bajtów wytwarzanych przez zakodowanie zestawu znaków z określonego ciągu.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified string.

(Odziedziczone po Encoding)
GetBytes(Char*, Int32, Byte*, Int32)

Koduje zestaw znaków, zaczynając od określonego wskaźnika znakowego do sekwencji bajtów, które są przechowywane, zaczynając od określonego wskaźnika bajtu.Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

GetBytes(Char*, Int32, Byte*, Int32)

Gdy jest zastępowany w klasie pochodnej, koduje zestaw znaków, zaczynając od określonego wskaźnika znakowego do sekwencji bajtów, które są przechowywane Zaczynając od określonego wskaźnika Byte.When overridden in a derived class, encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

(Odziedziczone po Encoding)
GetBytes(Char[])

Gdy jest zastępowany w klasie pochodnej, koduje wszystkie znaki w określonej tablicy znaków w sekwencji bajtów.When overridden in a derived class, encodes all the characters in the specified character array into a sequence of bytes.

(Odziedziczone po Encoding)
GetBytes(Char[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, koduje zestaw znaków z określonej tablicy znaków w sekwencji bajtów.When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of bytes.

(Odziedziczone po Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Koduje zestaw znaków z określonej tablicy znaków w określonej tablicy bajtów.Encodes a set of characters from the specified character array into the specified byte array.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Gdy jest zastępowany w klasie pochodnej, koduje do zakresu bajtów zestaw znaków z określonego obszaru tylko do odczytu.When overridden in a derived class, encodes into a span of bytes a set of characters from the specified read-only span.

(Odziedziczone po Encoding)
GetBytes(String)

Koduje zestaw znaków z określonego ciągu w określonej tablicy bajtów.Encodes a set of characters from the specified string into the specified byte array.

GetBytes(String)

Gdy jest zastępowany w klasie pochodnej, koduje wszystkie znaki w określonym ciągu do sekwencji bajtów.When overridden in a derived class, encodes all the characters in the specified string into a sequence of bytes.

(Odziedziczone po Encoding)
GetBytes(String, Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, koduje tablicę bajtów liczbę znaków określoną przez count określony ciąg, rozpoczynając od określonego index .When overridden in a derived class, encodes into an array of bytes the number of characters specified by count in the specified string, starting from the specified index.

(Odziedziczone po Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)

Koduje zestaw znaków z określonego String w określonej tablicy bajtów.Encodes a set of characters from the specified String into the specified byte array.

GetCharCount(Byte*, Int32)

Oblicza liczbę znaków wytworzonych przez dekodowanie sekwencji bajtów, zaczynając od określonego wskaźnika bajtu.Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

GetCharCount(Byte*, Int32)

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę znaków wytworzonych przez dekodowanie sekwencji bajtów, zaczynając od określonego wskaźnika Byte.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

(Odziedziczone po Encoding)
GetCharCount(Byte[])

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę znaków wytworzonych przez odkodowanie wszystkich bajtów w określonej tablicy bajtów.When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.

(Odziedziczone po Encoding)
GetCharCount(Byte[], Int32, Int32)

Oblicza liczbę znaków wytworzonych przez dekodowanie sekwencji bajtów z określonej tablicy bajtów.Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(ReadOnlySpan<Byte>)

Gdy jest zastępowany w klasie pochodnej, oblicza liczbę znaków wytworzonych przez dekodowanie podanego zakresu bajtów tylko do odczytu.When overridden in a derived class, calculates the number of characters produced by decoding the provided read-only byte span.

(Odziedziczone po Encoding)
GetChars(Byte*, Int32, Char*, Int32)

Dekoduje sekwencję bajtów rozpoczynającą się od określonego wskaźnika Byte do zestawu znaków, które są przechowywane, zaczynając od określonego wskaźnika znakowego.Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

GetChars(Byte*, Int32, Char*, Int32)

Gdy jest zastępowany w klasie pochodnej, dekoduje sekwencję bajtów, zaczynając od określonego wskaźnika Byte do zestawu znaków, które są przechowywane, zaczynając od określonego wskaźnika znakowego.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

(Odziedziczone po Encoding)
GetChars(Byte[])

Gdy jest zastępowany w klasie pochodnej, dekoduje wszystkie bajty w określonej tablicy bajtów do zestawu znaków.When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.

(Odziedziczone po Encoding)
GetChars(Byte[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, dekoduje sekwencję bajtów z określonej tablicy bajtów do zestawu znaków.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.

(Odziedziczone po Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)

Dekoduje sekwencję bajtów z określonej tablicy bajtów do określonej tablicy znaków.Decodes a sequence of bytes from the specified byte array into the specified character array.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Gdy jest zastępowany w klasie pochodnej, dekoduje wszystkie bajty w określonym zakresie bajtów tylko do odczytu do zakresu znaków.When overridden in a derived class, decodes all the bytes in the specified read-only byte span into a character span.

(Odziedziczone po Encoding)
GetDecoder()

Uzyskuje dekoder, który konwertuje zakodowaną sekwencję bajtów UTF-16 na sekwencję znaków Unicode.Obtains a decoder that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.

GetEncoder()

Uzyskuje koder, który konwertuje sekwencję znaków Unicode na sekwencję bajtów w formacie UTF-16.Obtains an encoder that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.

GetEncoder()

Gdy jest zastępowany w klasie pochodnej, uzyskuje koder, który konwertuje sekwencję znaków Unicode na zakodowaną sekwencję bajtów.When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.

(Odziedziczone po Encoding)
GetHashCode()

Zwraca kod skrótu dla bieżącego wystąpienia.Returns the hash code for the current instance.

GetMaxByteCount(Int32)

Oblicza maksymalną liczbę bajtów wyprodukowanych przez zakodowanie określonej liczby znaków.Calculates the maximum number of bytes produced by encoding the specified number of characters.

GetMaxCharCount(Int32)

Oblicza maksymalną liczbę znaków wyprodukowanych przez dekodowanie określonej liczby bajtów.Calculates the maximum number of characters produced by decoding the specified number of bytes.

GetPreamble()

Zwraca znacznik kolejności bajtów Unicode zakodowany w formacie UTF-16, jeśli Konstruktor dla tego wystąpienia żąda znacznika kolejności bajtów.Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.

GetString(Byte*, Int32)

Gdy jest zastępowany w klasie pochodnej, dekoduje określoną liczbę bajtów, zaczynając od określonego adresu do ciągu.When overridden in a derived class, decodes a specified number of bytes starting at a specified address into a string.

(Odziedziczone po Encoding)
GetString(Byte[])

Gdy jest zastępowany w klasie pochodnej, dekoduje wszystkie bajty w określonej tablicy bajtów do ciągu.When overridden in a derived class, decodes all the bytes in the specified byte array into a string.

(Odziedziczone po Encoding)
GetString(Byte[], Int32, Int32)

Dekoduje zakres bajtów z tablicy bajtowej do ciągu.Decodes a range of bytes from a byte array into a string.

GetString(Byte[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, dekoduje sekwencję bajtów z określonej tablicy bajtów do ciągu.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a string.

(Odziedziczone po Encoding)
GetString(ReadOnlySpan<Byte>)

Gdy jest zastępowany w klasie pochodnej, dekoduje wszystkie bajty w określonym przedziale bajtów do ciągu.When overridden in a derived class, decodes all the bytes in the specified byte span into a string.

(Odziedziczone po Encoding)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsAlwaysNormalized()

Pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane, przy użyciu domyślnego formularza normalizacji.Gets a value indicating whether the current encoding is always normalized, using the default normalization form.

(Odziedziczone po Encoding)
IsAlwaysNormalized(NormalizationForm)

Gdy jest zastępowany w klasie pochodnej, pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane, przy użyciu podanego formularza normalizacji.When overridden in a derived class, gets a value indicating whether the current encoding is always normalized, using the specified normalization form.

(Odziedziczone po Encoding)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Metody rozszerzania

GetBytes(Encoding, ReadOnlySequence<Char>)

Koduje określony ReadOnlySequence<T> do Byte tablicy przy użyciu określonego Encoding .Encodes the specified ReadOnlySequence<T> into a Byte array using the specified Encoding.

GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)

Dekoduje określony ReadOnlySequence<T> do byte s przy użyciu określonego Encoding i zapisuje wynik do writer .Decodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and writes the result to writer.

GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)

Koduje określony ReadOnlySequence<T> do byte s przy użyciu określonego Encoding i wyprowadza wynik do bytes .Encodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and outputs the result to bytes.

GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)

Koduje określony ReadOnlySpan<T> do byte s przy użyciu określonego Encoding i zapisuje wynik do writer .Encodes the specified ReadOnlySpan<T> to bytes using the specified Encoding and writes the result to writer.

GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)

Dekoduje określony ReadOnlySequence<T> do char s przy użyciu określonego Encoding i zapisuje wynik do writer .Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and writes the result to writer.

GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)

Dekoduje określony ReadOnlySequence<T> do char s przy użyciu określonego Encoding i wyprowadza wynik do chars .Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and outputs the result to chars.

GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)

Dekoduje określony ReadOnlySpan<T> do char s przy użyciu określonego Encoding i zapisuje wynik do writer .Decodes the specified ReadOnlySpan<T> to chars using the specified Encoding and writes the result to writer.

GetString(Encoding, ReadOnlySequence<Byte>)

Dekoduje określony ReadOnlySequence<T> do String przy użyciu określonego Encoding .Decodes the specified ReadOnlySequence<T> into a String using the specified Encoding.

Dotyczy

Zobacz też