TextEncoder.Encode Método

Definición

Espacio de nombres:

System.Text.Encodings.Web

Ensamblado:

System.Text.Encodings.Web.dll

Sobrecargas

Encode(String)	Codifica la cadena proporcionada y devuelve el texto codificado como una nueva cadena.
Encode(TextWriter, String)	Codifica la cadena especificada en un objeto TextWriter.
Encode(TextWriter, Char[], Int32, Int32)	Codifica los caracteres de una matriz y los escribe en un objeto TextWriter.
Encode(TextWriter, String, Int32, Int32)	Codifica una subcadena y la escribe en un objeto TextWriter.
Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)	Codifica los caracteres proporcionados.

Encode(String)

Codifica la cadena proporcionada y devuelve el texto codificado como una nueva cadena.

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

Cadena que se va a codificar.

Devoluciones

String

Cadena codificada.

Excepciones

ArgumentNullException

value es null.

ArgumentException

Error del método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). El codificador no implementa MaxOutputCharactersPerInputCharacter correctamente.

Encode(TextWriter, String)

Codifica la cadena especificada en un 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

Secuencia en la que se va a escribir el texto codificado.

value

String

Cadena que se va a codificar.

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

Codifica los caracteres de una matriz y los escribe en un 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

Secuencia en la que se va a escribir el texto codificado.

value

Char[]

Matriz de caracteres que se van a codificar.

startIndex

Int32

Índice de matriz del primer carácter que se va a codificar.

characterCount

Int32

Número de caracteres de la matriz que se van a codificar.

Excepciones

ArgumentNullException

output es null.

ArgumentException

Error del método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). El codificador no implementa MaxOutputCharactersPerInputCharacter correctamente.

ArgumentNullException

value es null.

ArgumentOutOfRangeException

startIndex está fuera del intervalo.

ArgumentOutOfRangeException

characterCount está fuera del intervalo.

Encode(TextWriter, String, Int32, Int32)

Codifica una subcadena y la escribe en un 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

Secuencia en la que se va a escribir el texto codificado.

value

String

Cadena cuya subcadena se va a codificar.

startIndex

Int32

Índice donde comienza la subcadena.

characterCount

Int32

Número de caracteres de la subcadena.

Excepciones

ArgumentNullException

output es null.

ArgumentException

Error del método TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). El codificador no implementa MaxOutputCharactersPerInputCharacter correctamente.

ArgumentNullException

value es null.

ArgumentOutOfRangeException

startIndex está fuera del intervalo.

ArgumentOutOfRangeException

characterCount está fuera del intervalo.

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

Codifica los caracteres proporcionados.

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>

Búfer de origen que contiene los caracteres que se van a codificar.

destination

Span<Char>

Búfer de destino en el que se escribirá la forma codificada de source.

charsConsumed

Int32

Número de caracteres consumidos desde el búfer source.

charsWritten

Int32

Número de caracteres escritos en el búfer destination.

isFinalBlock

Boolean

true para indicar que no hay más datos de origen que se deban codificar; en caso contrario, false.

Devoluciones

OperationStatus

Valor de enumeración que describe el resultado de la operación de codificación.

Comentarios

Los búferes source y destination no deben superponerse.