TextEncoder.Encode Метод

Определение

Перегрузки

Encode(String)

Кодирует указанную строку и возвращает кодированный текст в виде новой строки.Encodes the supplied string and returns the encoded text as a new string.

Encode(TextWriter, String)

Кодирует указанную строку в объект TextWriter.Encodes the specified string to a TextWriter object.

Encode(TextWriter, Char[], Int32, Int32)

Кодирует символы из массива и записывает их в объект TextWriter.Encodes characters from an array and writes them to a TextWriter object.

Encode(TextWriter, String, Int32, Int32)

Кодирует подстроку и записывает ее в объект TextWriter.Encodes a substring and writes it to a TextWriter object.

Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)

Кодирует указанные символы.Encodes the supplied characters.

Encode(String)

Кодирует указанную строку и возвращает кодированный текст в виде новой строки.Encodes the supplied string and returns the encoded text as a new string.

public:
 virtual System::String ^ Encode(System::String ^ value);
public virtual string Encode (string value);
abstract member Encode : string -> string
override this.Encode : string -> string
Public Overridable Function Encode (value As String) As String

Параметры

value
String

Кодируемая строка.The string to encode.

Возвращаемое значение

String

Закодированная строка.The encoded string.

Исключения

value имеет значение null.value is null.

Метод TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) завершился сбоем.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. Кодировщик не реализует MaxOutputCharactersPerInputCharacter правильно.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

Применяется к

Encode(TextWriter, String)

Кодирует указанную строку в объект TextWriter.Encodes the specified string to a TextWriter object.

public:
 void Encode(System::IO::TextWriter ^ output, System::String ^ value);
public void Encode (System.IO.TextWriter output, string value);
member this.Encode : System.IO.TextWriter * string -> unit
Public Sub Encode (output As TextWriter, value As String)

Параметры

output
TextWriter

Поток для записи кодированного текста.The stream to which to write the encoded text.

value
String

Кодируемая строка.The string to encode.

Применяется к

Encode(TextWriter, Char[], Int32, Int32)

Кодирует символы из массива и записывает их в объект TextWriter.Encodes characters from an array and writes them to a TextWriter object.

public:
 virtual void Encode(System::IO::TextWriter ^ output, cli::array <char> ^ value, int startIndex, int characterCount);
public virtual void Encode (System.IO.TextWriter output, char[] value, int startIndex, int characterCount);
abstract member Encode : System.IO.TextWriter * char[] * int * int -> unit
override this.Encode : System.IO.TextWriter * char[] * int * int -> unit
Public Overridable Sub Encode (output As TextWriter, value As Char(), startIndex As Integer, characterCount As Integer)

Параметры

output
TextWriter

Поток для записи кодированного текста.The stream to which to write the encoded text.

value
Char[]

Массив символов для кодирования.The array of characters to encode.

startIndex
Int32

Индекс массива первого кодируемого символа.The array index of the first character to encode.

characterCount
Int32

Количество символов в массиве, которое необходимо кодировать.The number of characters in the array to encode.

Исключения

output имеет значение null.output is null.

Метод TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) завершился сбоем.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. Кодировщик не реализует MaxOutputCharactersPerInputCharacter правильно.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

value имеет значение null.value is null.

startIndex выходит за пределы диапазона.startIndex is out of range.

characterCount выходит за пределы диапазона.characterCount is out of range.

Применяется к

Encode(TextWriter, String, Int32, Int32)

Кодирует подстроку и записывает ее в объект TextWriter.Encodes a substring and writes it to a TextWriter object.

public:
 virtual void Encode(System::IO::TextWriter ^ output, System::String ^ value, int startIndex, int characterCount);
public virtual void Encode (System.IO.TextWriter output, string value, int startIndex, int characterCount);
abstract member Encode : System.IO.TextWriter * string * int * int -> unit
override this.Encode : System.IO.TextWriter * string * int * int -> unit
Public Overridable Sub Encode (output As TextWriter, value As String, startIndex As Integer, characterCount As Integer)

Параметры

output
TextWriter

Поток для записи кодированного текста.The stream to which to write the encoded text.

value
String

Строка, подстроку которой необходимо кодировать.The string whose substring is to be encoded.

startIndex
Int32

Индекс, в котором начинается подстрока.The index where the substring starts.

characterCount
Int32

Число символов в подстроке.The number of characters in the substring.

Исключения

output имеет значение null.output is null.

Метод TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) завершился сбоем.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. Кодировщик не реализует MaxOutputCharactersPerInputCharacter правильно.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

value имеет значение null.value is null.

startIndex выходит за пределы диапазона.startIndex is out of range.

characterCount выходит за пределы диапазона.characterCount is out of range.

Применяется к

Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)

Кодирует указанные символы.Encodes the supplied characters.

public virtual System.Buffers.OperationStatus Encode (ReadOnlySpan<char> source, Span<char> destination, out int charsConsumed, out int charsWritten, bool isFinalBlock = true);
abstract member Encode : ReadOnlySpan<char> * Span<char> * int * int * bool -> System.Buffers.OperationStatus
override this.Encode : ReadOnlySpan<char> * Span<char> * int * int * bool -> System.Buffers.OperationStatus
Public Overridable Function Encode (source As ReadOnlySpan(Of Char), destination As Span(Of Char), ByRef charsConsumed As Integer, ByRef charsWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus

Параметры

source
ReadOnlySpan<Char>

Исходный буфер, содержащий символы для кодирования.A source buffer containing the characters to encode.

destination
Span<Char>

Буфер назначения, в который будет записана закодированная форма source.The destination buffer to which the encoded form of source will be written.

charsConsumed
Int32

Количество символов, использованных из буфера source.The number of characters consumed from the source buffer.

charsWritten
Int32

Количество символов, записанных в буфер destination.The number of characters written to the destination buffer.

isFinalBlock
Boolean

Значение true, если нет дополнительных исходных данных для кодирования, иначе — false.true to indicate there is no further source data that needs to be encoded; otherwise, false.

Возвращаемое значение

OperationStatus

Значение перечисления, описывающее результат операции кодирования.An enumeration value that describes the result of the encoding operation.

Комментарии

Буферы source и destination не должны перекрываться.The buffers source and destination must not overlap.

Применяется к