TextEncoder.Encode Método

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.

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.

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.

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.

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.