TextEncoder.Encode Méthode

Définition

Espace de noms:

System.Text.Encodings.Web

Assembly:

System.Text.Encodings.Web.dll

Surcharges

Encode(String)	Encode la chaîne fournie et retourne le texte encodé sous la forme d’une nouvelle chaîne.
Encode(TextWriter, String)	Encode la chaîne spécifiée en objet TextWriter.
Encode(TextWriter, Char[], Int32, Int32)	Encode les caractères à partir d’un tableau et les écrit dans un objet TextWriter.
Encode(TextWriter, String, Int32, Int32)	Encode une sous-chaîne et l’écrit dans un objet TextWriter.
Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)	Encode les caractères fournis.

Encode(String)

Encode la chaîne fournie et retourne le texte encodé sous la forme d’une nouvelle chaîne.

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

Paramètres

value

String

Chaîne à encoder.

Retours

String

Chaîne encodée.

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentException

Échec de la méthode TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). L’encodeur n’implémente pas MaxOutputCharactersPerInputCharacter correctement.

Encode(TextWriter, String)

Encode la chaîne spécifiée en objet 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)

Paramètres

output

TextWriter

Flux dans lequel écrire le texte encodé.

value

String

Chaîne à encoder.

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

Encode les caractères à partir d’un tableau et les écrit dans un objet 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)

Paramètres

output

TextWriter

Flux dans lequel écrire le texte encodé.

value

Char[]

Tableau de caractères à encoder.

startIndex

Int32

Index de tableau du premier caractère à encoder.

characterCount

Int32

Nombre de caractères dans le tableau à encoder.

Exceptions

ArgumentNullException

output a la valeur null.

ArgumentException

Échec de la méthode TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). L’encodeur n’implémente pas MaxOutputCharactersPerInputCharacter correctement.

ArgumentNullException

value a la valeur null.

ArgumentOutOfRangeException

startIndex est hors limites.

ArgumentOutOfRangeException

characterCount est hors limites.

Encode(TextWriter, String, Int32, Int32)

Encode une sous-chaîne et l’écrit dans un objet 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)

Paramètres

output

TextWriter

Flux dans lequel écrire le texte encodé.

value

String

Chaîne dont la sous-chaîne doit être encodée.

startIndex

Int32

Index où commence la sous-chaîne.

characterCount

Int32

Nombre de caractères dans la sous-chaîne.

Exceptions

ArgumentNullException

output a la valeur null.

ArgumentException

Échec de la méthode TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32). L’encodeur n’implémente pas MaxOutputCharactersPerInputCharacter correctement.

ArgumentNullException

value a la valeur null.

ArgumentOutOfRangeException

startIndex est hors limites.

ArgumentOutOfRangeException

characterCount est hors limites.

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

Encode les caractères fournis.

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

Paramètres

source

ReadOnlySpan<Char>

Mémoire tampon source contenant les caractères à encoder.

destination

Span<Char>

Mémoire tampon de destination dans laquelle la forme encodée de source sera écrite.

charsConsumed

Int32

Nombre de caractères consommés à partir de la mémoire tampon source.

charsWritten

Int32

Nombre de caractères consommés écrits dans la mémoire tampon destination.

isFinalBlock

Boolean

true pour indiquer qu’il n’y a pas d’autres données sources à encoder ; sinon false.

Retours

OperationStatus

Valeur d’énumération qui décrit le résultat de l’opération d’encodage.

Remarques

Les mémoires tampons source et destination ne doivent pas chevaucher.