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