Decoder.GetCharCount Methode

Definitie

Naamruimte:: System.Text

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Assembly's:: mscorlib.dll, System.Text.Encoding.dll

Assembly:: System.Text.Encoding.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes.

Overloads

Name	Description
GetCharCount(ReadOnlySpan<Byte>, Boolean)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door de reeks bytes in de periode te decoderen. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.
GetCharCount(Byte*, Int32, Boolean)	Wanneer deze worden overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door een reeks bytes te decoderen die beginnen bij de opgegeven byteaanwijzer. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.
GetCharCount(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.
GetCharCount(Byte[], Int32, Int32, Boolean)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.

GetCharCount(ReadOnlySpan<Byte>, Boolean)

Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door de reeks bytes in de periode te decoderen. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.

public:
 virtual int GetCharCount(ReadOnlySpan<System::Byte> bytes, bool flush);

public virtual int GetCharCount(ReadOnlySpan<byte> bytes, bool flush);

abstract member GetCharCount : ReadOnlySpan<byte> * bool -> int
override this.GetCharCount : ReadOnlySpan<byte> * bool -> int

Public Overridable Function GetCharCount (bytes As ReadOnlySpan(Of Byte), flush As Boolean) As Integer

Parameters

bytes: ReadOnlySpan<Byte>

Een bytespanne om te decoderen.

flush: Boolean

true om na de berekening de interne status van de encoder te simuleren; anders, false.

Retouren

Int32

Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes en bytes in de interne buffer te decoderen.

Opmerkingen

Deze methode heeft geen invloed op de status van de decoder.

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.

Van toepassing op

GetCharCount(Byte*, Int32, Boolean)

Belangrijk

Deze API is niet CLS-conform.

Wanneer deze worden overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door een reeks bytes te decoderen die beginnen bij de opgegeven byteaanwijzer. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.

public:
 virtual int GetCharCount(System::Byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount(byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetCharCount(byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
public virtual int GetCharCount(byte* bytes, int count, bool flush);

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

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

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

Parameters

bytes: Byte*

Een aanwijzer naar de eerste byte om te decoderen.

count: Int32

Het aantal bytes dat moet worden gedecodeerd.

flush: Boolean

true om na de berekening de interne status van de encoder te simuleren; anders, false.

Retouren

Int32

Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes en bytes in de interne buffer te decoderen.

Kenmerken: CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

bytes is null (Nothing in Visual Basic .NET).

ArgumentOutOfRangeException

count is kleiner dan nul.

DecoderFallbackException

Er is een terugval opgetreden (zie Character Encoding in .NET)

Fallback is ingesteld op DecoderExceptionFallback.

Opmerkingen

Deze methode heeft geen invloed op de status van de decoder.

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

Zie ook

Van toepassing op

GetCharCount(Byte[], Int32, Int32)

Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.

public:
 abstract int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);

public abstract int GetCharCount(byte[] bytes, int index, int count);

abstract member GetCharCount : byte[] * int * int -> int

Public MustOverride Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Parameters

bytes: Byte[]

De bytematrix met de reeks bytes die moet worden gedecodeerd.

index: Int32

De index van de eerste byte om te decoderen.

count: Int32

Het aantal bytes dat moet worden gedecodeerd.

Retouren

Int32

Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes en bytes in de interne buffer te decoderen.

Uitzonderingen

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

index of count kleiner is dan nul.

– of –

index en count geef geen geldig bereik aan in bytes.

DecoderFallbackException

Er is een terugval opgetreden (zie Character Encoding in .NET)

Fallback is ingesteld op DecoderExceptionFallback.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de GetCharCount methode gebruikt om het aantal tekens te berekenen dat is vereist om het opgegeven bereik van bytes in de matrix te decoderen.

using System;
using System.Text;

class DecoderExample {
    public static void Main() {
        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);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

/* This code example produces the following output.

7 characters needed to decode bytes.

*/

Imports System.Text

Class DecoderExample
    
    Public Shared Sub Main()
        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)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

'This code example produces the following output.
'
'7 characters needed to decode bytes.
'

Opmerkingen

Deze methode heeft geen invloed op de status van de decoder.

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

Zie ook

Van toepassing op

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

Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix. Een parameter geeft aan of de interne status van de decoder na de berekening moet worden gewist.

public:
 virtual int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count, bool flush);

public virtual int GetCharCount(byte[] bytes, int index, int count, bool flush);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount(byte[] bytes, int index, int count, bool flush);

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

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

Public Overridable Function GetCharCount (bytes As Byte(), index As Integer, count As Integer, flush As Boolean) As Integer

Parameters

bytes: Byte[]

De bytematrix met de reeks bytes die moet worden gedecodeerd.

index: Int32

De index van de eerste byte om te decoderen.

count: Int32

Het aantal bytes dat moet worden gedecodeerd.

flush: Boolean

true om na de berekening de interne status van de encoder te simuleren; anders, false.

Retouren

Int32

Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes en bytes in de interne buffer te decoderen.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

index of count kleiner is dan nul.

– of –

index en count geef geen geldig bereik aan in bytes.

DecoderFallbackException

Er is een terugval opgetreden (zie Character Encoding in .NET)

Fallback is ingesteld op DecoderExceptionFallback.

Opmerkingen

Deze methode heeft geen invloed op de status van de decoder.

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

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?