UnicodeEncoding.GetCharCount Methode
Definitie
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.
Berekent het aantal tekens dat wordt geproduceerd door een reeks bytes te decoderen.
Overloads
| Name | Description |
|---|---|
| GetCharCount(Byte*, Int32) |
Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes die beginnen bij de opgegeven byteaanwijzer. |
| GetCharCount(Byte[], Int32, Int32) |
Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix. |
GetCharCount(Byte*, Int32)
Belangrijk
Deze API is niet CLS-conform.
Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes die beginnen bij de opgegeven byteaanwijzer.
public:
override int GetCharCount(System::Byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> intParameters
- bytes
- Byte*
Een aanwijzer naar de eerste byte om te decoderen.
- count
- Int32
Het aantal bytes dat moet worden gedecodeerd.
Retouren
Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes te decoderen.
- Kenmerken
Uitzonderingen
bytes is null (Nothing).
count is kleiner dan nul.
– of –
Het resulterende aantal bytes is groter dan het maximumaantal dat als geheel getal kan worden geretourneerd.
Foutdetectie is ingeschakeld en bytes bevat een ongeldige reeks bytes.
Er is een terugval opgetreden (zie Character Encoding in .NET)
en
DecoderFallback is ingesteld op DecoderExceptionFallback.
Opmerkingen
Voor het berekenen van de exacte matrixgrootte die GetChars nodig is om de resulterende tekens op te slaan, gebruikt GetCharCountde toepassing . Als u de maximale matrixgrootte wilt berekenen, moet de toepassing gebruikmaken van GetMaxCharCount. De GetCharCount methode wijst doorgaans minder geheugen toe, terwijl de GetMaxCharCount methode over het algemeen sneller wordt uitgevoerd.
Bij foutdetectie zorgt een ongeldige reeks ervoor dat deze methode een ArgumentException. Zonder foutdetectie worden ongeldige reeksen genegeerd en wordt er geen uitzondering gegenereerd.
Zie ook
Van toepassing op
GetCharCount(Byte[], Int32, Int32)
Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);public override int GetCharCount(byte[] bytes, int index, int count);override this.GetCharCount : byte[] * int * int -> intPublic Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As IntegerParameters
- 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
Het aantal tekens dat wordt geproduceerd door de opgegeven reeks bytes te decoderen.
Uitzonderingen
bytes is null (Nothing).
index of count kleiner is dan nul.
– of –
index en count geef geen geldig bereik aan in bytes.
– of –
Het resulterende aantal bytes is groter dan het maximumaantal dat als geheel getal kan worden geretourneerd.
Foutdetectie is ingeschakeld en bytes bevat een ongeldige reeks bytes.
Er is een terugval opgetreden (zie Character Encoding in .NET)
en
DecoderFallback is ingesteld op DecoderExceptionFallback.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de GetCharCount methode gebruikt om het aantal tekens te retourneren dat wordt geproduceerd door het decoderen van een bereik van elementen in een bytematrix met behulp van UnicodeEncoding.
using System;
using System.Text;
class UnicodeEncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
};
UnicodeEncoding Unicode = new UnicodeEncoding();
int charCount = Unicode.GetCharCount(bytes, 2, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class UnicodeEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
Dim uni As New UnicodeEncoding()
Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
Opmerkingen
Voor het berekenen van de exacte matrixgrootte die is vereist voor GetChars het opslaan van de resulterende tekens, gebruikt GetCharCountde toepassing . Als u de maximale matrixgrootte wilt berekenen, moet de toepassing gebruikmaken van GetMaxCharCount. De GetCharCount methode wijst doorgaans minder geheugen toe, terwijl de GetMaxCharCount methode over het algemeen sneller wordt uitgevoerd.
Bij foutdetectie zorgt een ongeldige reeks ervoor dat deze methode een ArgumentException. Zonder foutdetectie worden ongeldige reeksen genegeerd en wordt er geen uitzondering gegenereerd.