TextEncoder.Encode Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
Die codierte Zeichenfolge.
Ausnahmen
value
ist null
.
Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.
Gilt für
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.
Gilt für
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
output
ist null
.
Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.
value
ist null
.
startIndex
liegt außerhalb des Bereichs.
characterCount
liegt außerhalb des Bereichs.
Gilt für
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
output
ist null
.
Fehler der TryEncodeUnicodeScalar(Int32, Char*, Int32, Int32)-Methode. Der Encoder implementiert MaxOutputCharactersPerInputCharacter nicht ordnungsgemäß.
value
ist null
.
startIndex
liegt außerhalb des Bereichs.
characterCount
liegt außerhalb des Bereichs.
Gilt für
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.
- 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
Ein Enumerationswert, der das Ergebnis des Codierungsvorgangs beschreibt.
Hinweise
Die Puffer source
und destination
dürfen nicht überlappen.