Decoder.GetChars Methode

public:
 virtual int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars, bool flush);

public virtual int GetChars(ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

abstract member GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int
override this.GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

Parameters

Retouren

Het werkelijke aantal tekens dat is geschreven op het bereik dat wordt aangegeven door de chars parameter.

Opmerkingen

Houd er rekening mee dat het object de Decoder status opslaat tussen aanroepen naar GetChars. Wanneer de toepassing wordt uitgevoerd met een gegevensstroom, moet deze de flush parameter instellen om true ervoor te zorgen dat de statusinformatie wordt leeggemaakt. Met deze instelling negeert de decoder ongeldige bytes aan het einde van het gegevensblok en wordt de interne buffer gewist.

Als u de exacte spangrootte wilt berekenen die GetChars nodig is om de resulterende tekens op te slaan, moet de toepassing worden gebruikt GetCharCount.

Als GetChars wordt aangeroepen met flush ingesteld op false, slaat de decoder volgbytes op aan het einde van het gegevensblok in een interne buffer en gebruikt deze in de volgende decoderingsbewerking. De toepassing moet onmiddellijk een blok met gegevens aanroepen GetCharCount voordat hetzelfde blok wordt aangeroepen GetChars , zodat eventuele volgbytes uit het vorige blok worden opgenomen in de berekening.

Als uw toepassing veel segmenten van een invoerstroom wilt converteren, kunt u overwegen de Convert methode te gebruiken. GetChars genereert een uitzondering als de uitvoerspanne niet groot genoeg is, maar Convert zo veel mogelijk ruimte opvult en de geschreven bytes en tekens retourneert, mits de uitvoermatrix ten minste twee tekens toestaat. Zie ook het Encoding.GetChars onderwerp voor meer opmerkingen.

public:
 virtual int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetChars(byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetChars(byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetChars(byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

Parameters

Retouren

Het werkelijke aantal tekens dat is geschreven op de locatie die door de chars parameter wordt aangegeven.

Kenmerken

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Uitzonderingen

Opmerkingen

Houd er rekening mee dat het object de Decoder status opslaat tussen aanroepen naar GetChars. Wanneer de toepassing wordt uitgevoerd met een gegevensstroom, moet deze de flush parameter instellen om true ervoor te zorgen dat de statusinformatie wordt leeggemaakt. Met deze instelling negeert de decoder ongeldige bytes aan het einde van het gegevensblok en wordt de interne buffer gewist.

Als u de exacte buffergrootte wilt berekenen die GetChars nodig is om de resulterende tekens op te slaan, moet de toepassing worden gebruikt GetCharCount.

Als GetChars wordt aangeroepen met flush ingesteld op false, slaat de decoder volgbytes op aan het einde van het gegevensblok in een interne buffer en gebruikt deze in de volgende decoderingsbewerking. De toepassing moet onmiddellijk een blok met gegevens aanroepen GetCharCount voordat hetzelfde blok wordt aangeroepen GetChars , zodat eventuele volgbytes uit het vorige blok worden opgenomen in de berekening.

Als uw toepassing veel segmenten van een invoerstroom wilt converteren, kunt u overwegen de Convert methode te gebruiken. GetChars genereert een uitzondering als de uitvoerbuffer niet groot genoeg is, maar Convert zo veel mogelijk ruimte opvult en de geschreven bytes en tekens retourneert, mits de uitvoermatrix ten minste twee tekens toestaat. Zie ook het Encoding.GetChars onderwerp voor meer opmerkingen.

Zie ook

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public abstract int GetChars(byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

abstract member GetChars : byte[] * int * int * char[] * int -> int

Public MustOverride Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parameters

Retouren

Het werkelijke aantal tekens dat is geschreven in chars.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een bereik van elementen uit een bytematrix decoderen en opslaat in een Unicode-tekenmatrix. De GetCharCount methode wordt gebruikt om het aantal tekens te berekenen dat nodig is voor het opslaan van de gedecodeerde elementen in de matrix bytes. De GetChars methode ontsleutelt de opgegeven elementen in de bytematrix en slaat deze op in de nieuwe tekenmatrix.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0)
        
        Console.WriteLine( _
            "{0} characters used to decode bytes.", _
            charsDecodedCount _
        )
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Opmerkingen

Houd er rekening mee dat het object de Decoder status opslaat tussen aanroepen naar GetChars. Wanneer de toepassing wordt uitgevoerd met een gegevensstroom, moet deze de flush parameter instellen om true ervoor te zorgen dat de statusinformatie wordt leeggemaakt. Met deze instelling negeert de decoder ongeldige bytes aan het einde van het gegevensblok en wordt de interne buffer gewist.

Als u de exacte matrixgrootte wilt berekenen die GetChars nodig is om de resulterende tekens op te slaan, moet de toepassing worden gebruikt GetCharCount.

Als GetChars wordt aangeroepen met flush ingesteld op false, slaat de decoder volgbytes op aan het einde van het gegevensblok in een interne buffer en gebruikt deze in de volgende decoderingsbewerking. De toepassing moet onmiddellijk een blok met gegevens aanroepen GetCharCount voordat hetzelfde blok wordt aangeroepen GetChars , zodat eventuele volgbytes uit het vorige blok worden opgenomen in de berekening.

Als uw toepassing veel segmenten van een invoerstroom wilt converteren, kunt u overwegen de Convert methode te gebruiken. GetChars genereert een uitzondering als de uitvoerbuffer niet groot genoeg is, maar Convert zo veel mogelijk ruimte opvult en de geschreven bytes en tekens retourneert, mits de uitvoermatrix ten minste twee tekens toestaat. Zie ook het Encoding.GetChars onderwerp voor meer opmerkingen.

Zie ook

• GetCharCount(Byte[], Int32, Int32)
• Reset()

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);

public virtual int GetChars(byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);

abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Parameters

Retouren

Het werkelijke aantal tekens dat in de chars parameter is geschreven.

Uitzonderingen

Opmerkingen

Houd er rekening mee dat het object de Decoder status opslaat tussen aanroepen naar GetChars. Wanneer de toepassing wordt uitgevoerd met een gegevensstroom, moet deze de flush parameter instellen om true ervoor te zorgen dat de statusinformatie wordt leeggemaakt. Met deze instelling negeert de decoder ongeldige bytes aan het einde van het gegevensblok en wordt de interne buffer gewist.

Als u de exacte matrixgrootte wilt berekenen die GetChars nodig is om de resulterende tekens op te slaan, moet de toepassing worden gebruikt GetCharCount.

Als GetChars wordt aangeroepen met flush ingesteld op false, slaat de decoder volgbytes op aan het einde van het gegevensblok in een interne buffer en gebruikt deze in de volgende decoderingsbewerking. De toepassing moet onmiddellijk een blok met gegevens aanroepen GetCharCount voordat hetzelfde blok wordt aangeroepen GetChars , zodat eventuele volgbytes uit het vorige blok worden opgenomen in de berekening.

Als uw toepassing veel segmenten van een invoerstroom wilt converteren, kunt u overwegen de Convert methode te gebruiken. GetChars genereert een uitzondering als de uitvoerbuffer niet groot genoeg is, maar Convert zo veel mogelijk ruimte opvult en de geschreven bytes en tekens retourneert, mits de uitvoermatrix ten minste twee tekens toestaat. Zie ook het Encoding.GetChars onderwerp voor meer opmerkingen.

Zie ook

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()