ASCIIEncoding.GetByteCount Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vypočítá počet bajtů vytvořených kódováním sady znaků.
Přetížení
GetByteCount(ReadOnlySpan<Char>) |
Vypočítá počet bajtů vytvořených kódováním zadaného rozsahu znaků. |
GetByteCount(String) |
Vypočítá počet bajtů vytvořených kódováním znaků v zadaném znaku String. |
GetByteCount(Char*, Int32) |
Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným ukazatelem znaků. |
GetByteCount(Char[], Int32, Int32) |
Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků. |
GetByteCount(ReadOnlySpan<Char>)
Vypočítá počet bajtů vytvořených kódováním zadaného rozsahu znaků.
public:
override int GetByteCount(ReadOnlySpan<char> chars);
public override int GetByteCount (ReadOnlySpan<char> chars);
override this.GetByteCount : ReadOnlySpan<char> -> int
Public Overrides Function GetByteCount (chars As ReadOnlySpan(Of Char)) As Integer
Parametry
- chars
- ReadOnlySpan<Char>
Rozsah obsahující sadu znaků, které se mají zakódovat.
Návraty
Počet bajtů vytvořených kódováním zadaného rozsahu znaků.
Poznámky
K výpočtu přesné velikosti požadované GetBytes k uložení výsledných bajtů použijte GetByteCount. K výpočtu maximální velikosti použijte GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Platí pro
GetByteCount(String)
Vypočítá počet bajtů vytvořených kódováním znaků v zadaném znaku String.
public:
override int GetByteCount(System::String ^ chars);
public override int GetByteCount (string chars);
override this.GetByteCount : string -> int
Public Overrides Function GetByteCount (chars As String) As Integer
Parametry
Návraty
Počet bajtů vytvořených kódováním zadaných znaků.
Výjimky
chars
je null
.
Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako celé číslo.
Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .
Příklady
Následující příklad ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných k kódování řetězce pomocí ASCIIEncoding.
using namespace System;
using namespace System::Text;
int main()
{
String^ chars = "ASCII Encoding Example";
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int byteCount = ascii->GetByteCount( chars );
Console::WriteLine( " {0} bytes needed to encode string.", byteCount );
}
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
String chars = "ASCII Encoding Example";
ASCIIEncoding ascii = new ASCIIEncoding();
int byteCount = ascii.GetByteCount(chars);
Console.WriteLine(
"{0} bytes needed to encode string.", byteCount
);
}
}
Imports System.Text
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim chars As String = "ASCII Encoding Example"
Dim ascii As New ASCIIEncoding()
Dim byteCount As Integer = ascii.GetByteCount(chars)
Console.WriteLine("{0} bytes needed to encode string.", byteCount)
End Sub
End Class
Poznámky
K výpočtu přesné velikosti pole vyžadované GetBytes k uložení výsledných bajtů používá GetByteCountaplikace . K výpočtu maximální velikosti pole by měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Viz také
Platí pro
GetByteCount(Char*, Int32)
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
- Alternativa odpovídající specifikaci CLS
- System.Text.ASCIIEncoding.GetByteCount(Char[], Int32, Int32)
Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným ukazatelem znaků.
public:
override int GetByteCount(char* chars, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetByteCount (char* chars, int count);
[System.CLSCompliant(false)]
public override int GetByteCount (char* chars, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetByteCount : nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
override this.GetByteCount : nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int
Parametry
- chars
- Char*
Ukazatel na první znak, který se má kódovat.
- count
- Int32
Počet znaků, které se mají kódovat.
Návraty
Počet bajtů vytvořených kódováním zadaných znaků.
- Atributy
Výjimky
chars
je null
.
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 celé číslo.
Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .
Poznámky
K výpočtu přesné velikosti pole vyžadované GetBytes k uložení výsledných bajtů používá GetByteCountaplikace . K výpočtu maximální velikosti pole by měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Viz také
Platí pro
GetByteCount(Char[], Int32, Int32)
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í kódovat.
- index
- Int32
Index prvního znaku, který se má kódovat.
- count
- Int32
Počet znaků, které se mají kódovat.
Návraty
Počet bajtů vytvořených kódováním zadaných znaků.
Výjimky
chars
je null
.
index
nebo count
je menší než nula.
-nebo-
index
a count
neoznamujte platnou oblast v chars
.
-nebo- Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako celé číslo.
Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .
Příklady
Následující příklad ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných ke kódování pole znaků Unicode pomocí ASCIIEncoding.
using namespace System;
using namespace System::Text;
int main()
{
// Unicode characters.
// Pi
// Sigma
array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int byteCount = ascii->GetByteCount( chars, 1, 2 );
Console::WriteLine( " {0} bytes needed to encode characters.", byteCount.ToString() );
}
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
ASCIIEncoding ascii = new ASCIIEncoding();
int byteCount = ascii.GetByteCount(chars, 1, 2);
Console.WriteLine(
"{0} bytes needed to encode characters.", byteCount
);
}
}
Imports System.Text
Imports Microsoft.VisualBasic.Strings
Class ASCIIEncodingExample
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 ascii As New ASCIIEncoding()
Dim byteCount As Integer = ascii.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 vyžadované GetBytes k uložení výsledných bajtů používá GetByteCountaplikace . K výpočtu maximální velikosti pole by měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.