Partilhar via

TextEncoder.Encode Método

  • Referência

Definição

Namespace:
System.Text.Encodings.Web
Assembly:
System.Text.Encodings.Web.dll

Sobrecargas

Encode(String)

Codifica a cadeia de caracteres fornecida e retorna o texto codificado como uma nova cadeia de caracteres.
Encode(TextWriter, String)

Codifica a cadeia de caracteres especificada em um objeto TextWriter.
Encode(TextWriter, Char[], Int32, Int32)

Codifica caracteres de uma matriz e grava-os em um objeto TextWriter.
Encode(TextWriter, String, Int32, Int32)

Codifica uma subcadeia e grava-a em um objeto TextWriter.
Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)

Codifica os caracteres fornecidos.

Encode(String)

Codifica a cadeia de caracteres fornecida e retorna o texto codificado como uma nova cadeia de caracteres.

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.

Retornos

String

A cadeia de caracteres codificada.

Exceções

ArgumentNullException

value é null.

ArgumentException

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.

Aplica-se a

Encode(TextWriter, String)

Codifica a cadeia de caracteres especificada em um objeto TextWriter.

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.

value
String

A cadeia de caracteres a ser codificada.

Aplica-se a

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

Codifica caracteres de uma matriz e grava-os em um objeto TextWriter.

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.

value
Char[]

A matriz de caracteres a ser codificada.

startIndex
Int32

O índice da matriz do primeiro caractere a ser codificado.

characterCount
Int32

O número de caracteres na matriz a ser codificado.

Exceções

ArgumentNullException

output é null.

ArgumentException

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex está fora do intervalo.

ArgumentOutOfRangeException

characterCount está fora do intervalo.

Aplica-se a

Encode(TextWriter, String, Int32, Int32)

Codifica uma subcadeia e grava-a em um objeto TextWriter.

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.

value
String

A cadeia de caracteres cuja subcadeia deve ser codificada.

startIndex
Int32

O índice em que a subcadeia começa.

characterCount
Int32

O número de caracteres na subcadeia de caracteres.

Exceções

ArgumentNullException

output é null.

ArgumentException

O método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32) falhou. O codificador não implementa MaxOutputCharactersPerInputCharacter corretamente.

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex está fora do intervalo.

ArgumentOutOfRangeException

characterCount está fora do intervalo.

Aplica-se a

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

Codifica os caracteres fornecidos.

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.

destination
Span<Char>

O buffer de destino no qual a forma codificada de source será regravada.

charsConsumed
Int32

O número de caracteres consumidos do buffer source.

charsWritten
Int32

O número de caracteres gravados no buffer destination.

isFinalBlock
Boolean

true para indicar que não há dados de origem adicionais que precisam ser codificados; caso contrário, false.

Retornos

OperationStatus

Um valor de enumeração que descreve o resultado da operação de codificação.

Comentários

Os buffers source e destination não devem se sobrepor.

Aplica-se a