UTF7Encoding.GetCharCount Metod

Definition

Namnområde:
System.Text
Sammansättningar:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Text.Encoding.Extensions.dll
Sammansättning:
netstandard.dll

Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte.

Överlagringar

Name Description
GetCharCount(Byte[], Int32, Int32)

Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte från den angivna bytematrisen.
GetCharCount(Byte*, Int32)

Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte som börjar vid den angivna bytepekaren.

GetCharCount(Byte[], Int32, Int32)

Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte från den angivna bytematrisen.

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 -> int
Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Parametrar

bytes
Byte[]

Bytematrisen som innehåller sekvensen med byte som ska avkodas.

index
Int32

Indexet för den första byte som ska avkodas.

count
Int32

Antalet byte som ska avkodas.

Returer

Int32

Antalet tecken som genereras genom avkodning av den angivna sekvensen med byte.

Undantag

ArgumentNullException

bytes är null (Nothing).

ArgumentOutOfRangeException

index eller count är mindre än noll.

-eller-

index och count ange inte ett giltigt intervall i bytes.

-eller-

Det resulterande antalet tecken är större än det maximala antal som kan returneras som en int.

DecoderFallbackException

En reserv inträffade (mer information finns i Character Encoding i .NET)

-och-

DecoderFallback är inställt på DecoderExceptionFallback.

Exempel

Följande kodexempel visar hur du använder GetCharCount metoden för att returnera antalet tecken som genereras genom avkodning av ett område med element i en bytematris.

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

Kommentarer

Om du vill beräkna den exakta matrisstorlek som krävs för GetChars att lagra de resulterande tecknen använder du GetCharCount. För att beräkna den maximala matrisstorleken bör programmet använda GetMaxCharCount. Metoden GetCharCount tillåter vanligtvis allokering av mindre minne, medan GetMaxCharCount metoden vanligtvis körs snabbare.

Se även

Gäller för

GetCharCount(Byte*, Int32)

Viktigt!

Detta API uppfyller inte CLS.

Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte som börjar vid den angivna bytepekaren.

public:
 override int GetCharCount(System::Byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

Parametrar

bytes
Byte*

En pekare till den första byte som ska avkodas.

count
Int32

Antalet byte som ska avkodas.

Returer

Int32

Antalet tecken som genereras genom avkodning av den angivna sekvensen med byte.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Undantag

ArgumentNullException

bytes är null (Nothing).

ArgumentOutOfRangeException

count är mindre än noll.

-eller-

Det resulterande antalet tecken är större än det maximala antal som kan returneras som en int.

DecoderFallbackException

En återställning inträffade (mer information finns i Character Encoding i .NET).

-och-

DecoderFallback är inställt på DecoderExceptionFallback.

Kommentarer

Om du vill beräkna den exakta matrisstorlek som krävs för GetChars att lagra de resulterande tecknen använder du GetCharCount. För att beräkna den maximala matrisstorleken bör programmet använda GetMaxCharCount. Metoden GetCharCount tillåter vanligtvis allokering av mindre minne, medan GetMaxCharCount metoden vanligtvis körs snabbare.

Se även

Gäller för