TextEncoder.Encode Método

Definição

Sobrecargas

Encode(String)

Codifica a cadeia de caracteres fornecida e retorna o texto codificado como uma nova cadeia de caracteres.Encodes the supplied string and returns the encoded text as a new string.

Encode(TextWriter, String)

Codifica a cadeia de caracteres especificada em um objeto TextWriter.Encodes the specified string to a TextWriter object.

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

Codifica caracteres de uma matriz e grava-os em um objeto TextWriter.Encodes characters from an array and writes them to a TextWriter object.

Encode(TextWriter, String, Int32, Int32)

Codifica uma subcadeia e grava-a em um objeto TextWriter.Encodes a substring and writes it to a TextWriter object.

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

Codifica os caracteres fornecidos.Encodes the supplied characters.

Encode(String)

Codifica a cadeia de caracteres fornecida e retorna o texto codificado como uma nova cadeia de caracteres.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

Parâmetros

value
String

A cadeia de caracteres a ser codificada.The string to encode.

Retornos

String

A cadeia de caracteres codificada.The encoded string.

Exceções

value é null.value is null.

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

Aplica-se a

Encode(TextWriter, String)

Codifica a cadeia de caracteres especificada em um objeto 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)

Parâmetros

output
TextWriter

O fluxo no qual gravar o texto codificado.The stream to which to write the encoded text.

value
String

A cadeia de caracteres a ser codificada.The string to encode.

Aplica-se a

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

Codifica caracteres de uma matriz e grava-os em um objeto 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)

Parâmetros

output
TextWriter

O fluxo no qual gravar o texto codificado.The stream to which to write the encoded text.

value
Char[]

A matriz de caracteres a ser codificada.The array of characters to encode.

startIndex
Int32

O índice da matriz do primeiro caractere a ser codificado.The array index of the first character to encode.

characterCount
Int32

O número de caracteres na matriz a ser codificado.The number of characters in the array to encode.

Exceções

output é null.output is null.

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

value é null.value is null.

startIndex está fora do intervalo.startIndex is out of range.

characterCount está fora do intervalo.characterCount is out of range.

Aplica-se a

Encode(TextWriter, String, Int32, Int32)

Codifica uma subcadeia e grava-a em um objeto 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)

Parâmetros

output
TextWriter

O fluxo no qual gravar o texto codificado.The stream to which to write the encoded text.

value
String

A cadeia de caracteres cuja subcadeia deve ser codificada.The string whose substring is to be encoded.

startIndex
Int32

O índice em que a subcadeia começa.The index where the substring starts.

characterCount
Int32

O número de caracteres na subcadeia de caracteres.The number of characters in the substring.

Exceções

output é null.output is null.

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou.The TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) method failed. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.The encoder does not implement MaxOutputCharactersPerInputCharacter correctly.

value é null.value is null.

startIndex está fora do intervalo.startIndex is out of range.

characterCount está fora do intervalo.characterCount is out of range.

Aplica-se a

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

Codifica os caracteres fornecidos.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

Parâmetros

source
ReadOnlySpan<Char>

Um buffer de origem que contém os caracteres a serem codificados.A source buffer containing the characters to encode.

destination
Span<Char>

O buffer de destino no qual a forma codificada de source será regravada.The destination buffer to which the encoded form of source will be written.

charsConsumed
Int32

O número de caracteres consumidos do buffer source.The number of characters consumed from the source buffer.

charsWritten
Int32

O número de caracteres gravados no buffer destination.The number of characters written to the destination buffer.

isFinalBlock
Boolean

true para indicar que não há dados de origem adicionais que precisam ser codificados; caso contrário, false.true to indicate there is no further source data that needs to be encoded; otherwise, false.

Retornos

OperationStatus

Um valor de enumeração que descreve o resultado da operação de codificação.An enumeration value that describes the result of the encoding operation.

Comentários

Os buffers source e destination não devem se sobrepor.The buffers source and destination must not overlap.

Aplica-se a