TextEncoder.Encode Methode

Definition

Namespace:

System.Text.Encodings.Web

Assembly:

System.Text.Encodings.Web.dll

Überlädt

Encode(String)	Codiert die bereitgestellte Zeichenfolge und gibt den codierten Text als neue Zeichenfolge zurück.
Encode(TextWriter, String)	Codiert die angegebene Zeichenfolge in ein TextWriter-Objekt.
Encode(TextWriter, Char[], Int32, Int32)	Codiert Zeichen aus einem Array und schreibt sie in ein TextWriter-Objekt.
Encode(TextWriter, String, Int32, Int32)	Codiert eine Teilzeichenfolge und schreibt sie in ein TextWriter-Objekt.
Encode(ReadOnlySpan<Char>, Span<Char>, Int32, Int32, Boolean)	Codiert die angegebenen Zeichen.

Encode(String)

Codiert die bereitgestellte Zeichenfolge und gibt den codierten Text als neue Zeichenfolge zurück.

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

Parameter

value

String

Die zu codierende Zeichenfolge.

Gibt zurück

String

Die codierte Zeichenfolge.

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.

Encode(TextWriter, String)

Codiert die angegebene Zeichenfolge in ein TextWriter-Objekt.

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)

Parameter

output

TextWriter

Der Stream, in den der codierte Text geschrieben werden soll.

value

String

Die zu codierende Zeichenfolge.

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

Codiert Zeichen aus einem Array und schreibt sie in ein TextWriter-Objekt.

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)

Parameter

output

TextWriter

Der Stream, in den der codierte Text geschrieben werden soll.

value

Char[]

Das zu codierende Array von Zeichen.

startIndex

Int32

Der Index eines Arrays des ersten zu codierenden Zeichens.

characterCount

Int32

Die Anzahl der Zeichen im zu codierenden Array.

Ausnahmen

ArgumentNullException

output ist null.

ArgumentException

Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex liegt außerhalb des Bereichs.

ArgumentOutOfRangeException

characterCount liegt außerhalb des Bereichs.

Encode(TextWriter, String, Int32, Int32)

Codiert eine Teilzeichenfolge und schreibt sie in ein TextWriter-Objekt.

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)

Parameter

output

TextWriter

Der Stream, in den der codierte Text geschrieben werden soll.

value

String

Die Zeichenfolge, deren Teilzeichenfolge codiert werden.

startIndex

Int32

Der Index, in der die Teilzeichenfolge neu gestartet wird.

characterCount

Int32

Die Anzahl der Zeichen in der Teilzeichenfolge.

Ausnahmen

ArgumentNullException

output ist null.

ArgumentException

Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex liegt außerhalb des Bereichs.

ArgumentOutOfRangeException

characterCount liegt außerhalb des Bereichs.

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

Codiert die angegebenen Zeichen.

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

Parameter

source

ReadOnlySpan<Char>

Ein Quellpuffer, der die zu codierenden Zeichen enthält.

destination

Span<Char>

Der Zielpuffer, in den die codierte Form von source geschrieben wird.

charsConsumed

Int32

Die Anzahl von Zeichen, die aus dem source-Puffer verwendet werden.

charsWritten

Int32

Die Anzahl von Zeichen, die in den destination-Puffer geschrieben werden.

isFinalBlock

Boolean

true, um anzugeben, dass keine weitere Quelldaten codiert werden müssen, andernfalls false.

Gibt zurück

OperationStatus

Ein Enumerationswert, der das Ergebnis des Codierungsvorgangs beschreibt.

Hinweise

Die Puffer source und destination dürfen nicht überlappen.