UTF7Encoding.GetByteCount Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Vypočítá počet bajtů vytvořených kódováním sady znaků.

Přetížení

GetByteCount(String)	Vypočítá počet bajtů vytvořených kódováním znaků v zadaném String objektu.
GetByteCount(Char*, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.
GetByteCount(Char[], Int32, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.

GetByteCount(String)

Zdroj:

UTF7Encoding.cs

Vypočítá počet bajtů vytvořených kódováním znaků v zadaném String objektu.

public:
 override int GetByteCount(System::String ^ s);

public override int GetByteCount (string s);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (s As String) As Integer

Parametry

s

String

Objekt String obsahující sadu znaků, které se mají zakódovat.

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků.

Výjimky

ArgumentNullException

s je null (Nothing).

ArgumentOutOfRangeException

Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako int.

EncoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET).

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných ke kódování pole znaků.

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int byteCount = utf7->GetByteCount( chars, 1, 2 );
   Console::WriteLine( "{0} bytes needed to encode characters.", byteCount );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        UTF7Encoding utf7 = new UTF7Encoding();
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}
        
        Dim utf7 As New UTF7Encoding()
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Poznámky

K výpočtu přesné velikosti pole, která GetBytes je nutná k uložení výsledných bajtů, aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

Viz také

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

GetByteCount(Char*, Int32)

Zdroj:

UTF7Encoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount (char* chars, int count);

[<System.CLSCompliant(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

Parametry

chars

Char*

Ukazatel na první znak, který se má zakódovat.

count

Int32

Počet znaků, které mají být zakódovány.

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

chars is null (Nothing v jazyce Visual Basic .NET).

ArgumentOutOfRangeException

Hodnota count je menší než nula.

-nebo-

Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako int.

EncoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Poznámky

K výpočtu přesné velikosti pole, která GetBytes je nutná k uložení výsledných bajtů, aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

Viz také

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

GetByteCount(Char[], Int32, Int32)

Zdroj:

UTF7Encoding.cs

Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

public override int GetByteCount (char[] chars, int index, int count);

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Parametry

chars

Char[]

Pole znaků obsahující sadu znaků, které se mají zakódovat.

index

Int32

Index prvního znaku, který má být kódován.

count

Int32

Počet znaků, které mají být zakódovány.

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků.

Výjimky

ArgumentNullException

chars je null (Nothing).

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neoznamují platnou oblast v charssouboru .

-nebo-

Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako int.

EncoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných ke kódování pole znaků Unicode.

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int byteCount = utf7->GetByteCount( chars, 1, 2 );
   Console::WriteLine( "{0} bytes needed to encode characters.", byteCount );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        UTF7Encoding utf7 = new UTF7Encoding();
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}
        
        Dim utf7 As New UTF7Encoding()
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Poznámky

K výpočtu přesné velikosti pole potřebné GetBytes k uložení výsledných bajtů aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

Viz také

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()