UTF7Encoding.GetByteCount Methode

Definition

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen erzeugt wird.Calculates the number of bytes produced by encoding a set of characters.

Überlädt

GetByteCount(String)

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen in das angegebene String-Objekt erzeugt werden.Calculates the number of bytes produced by encoding the characters in the specified String object.

GetByteCount(Char*, Int32)

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen ab dem angegebenen Zeichenzeiger erzeugt werden.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char[], Int32, Int32)

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen aus dem angegebenen Zeichenarray erzeugt werden.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(String)

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen in das angegebene String-Objekt erzeugt werden.Calculates the number of bytes produced by encoding the characters in the specified String object.

public:
 override int GetByteCount(System::String ^ s);
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (string s);
override this.GetByteCount : string -> int
Public Overrides Function GetByteCount (s As String) As Integer

Parameter

s
String

Das String-Objekt mit den zu codierenden Zeichen.The String object containing the set of characters to encode.

Gibt zurück

Die Anzahl der Bytes, die beim Codieren der angegebenen Zeichen erzeugt werden.The number of bytes produced by encoding the specified characters.

Attribute

Ausnahmen

s ist null(Nothing).s is null (Nothing).

Die daraus resultierende Byteanzahl ist größer als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.The resulting number of bytes is greater than the maximum number that can be returned as an int.

Es ist ein Fallback aufgetreten (eine ausführliche Erläuterung finden Sie unter Zeichencodierung in .NET Framework).A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation) - und --and- Für EncoderFallback ist EncoderExceptionFallback festgelegt.EncoderFallback is set to EncoderExceptionFallback.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetByteCount-Methode verwendet wird, um die Anzahl der Bytes zurückzugeben, die zum Codieren eines Zeichen Arrays benötigt werden.The following code example demonstrates how to use the GetByteCount method to return the number of bytes required to encode a character array.

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

Hinweise

Um die genaue Array Größe zu berechnen, die GetBytes zum Speichern der resultierenden Bytes erfordert, verwendet die Anwendung GetByteCount.To calculate the exact array size that GetBytes requires to store the resulting bytes, the application uses GetByteCount. Um die maximale Array Größe zu berechnen, sollte die Anwendung GetMaxByteCountverwenden.To calculate the maximum array size, the application should use GetMaxByteCount. Die GetByteCount-Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die GetMaxByteCount-Methode im Allgemeinen schneller ausgeführt wird.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Siehe auch

GetByteCount(Char*, Int32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen ab dem angegebenen Zeichenzeiger erzeugt werden.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

public:
 override int GetByteCount(char* chars, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public override int GetByteCount (char* chars, int count);
override this.GetByteCount : nativeptr<char> * int -> int

Parameter

chars
Char*

Ein Zeiger auf das erste zu codierende Zeichen.A pointer to the first character to encode.

count
Int32

Die Anzahl der zu codierenden Zeichen.The number of characters to encode.

Gibt zurück

Die Anzahl der Bytes, die beim Codieren der angegebenen Zeichen erzeugt werden.The number of bytes produced by encoding the specified characters.

Attribute

Ausnahmen

chars ist null (Nothing in Visual Basic .NET).chars is null (Nothing in Visual Basic .NET).

count ist kleiner als Null.count is less than zero.

- oder --or- Die daraus resultierende Byteanzahl ist größer als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.The resulting number of bytes is greater than the maximum number that can be returned as an int.

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).A fallback occurred (for more information, see Character Encoding in .NET) - und --and- Für EncoderFallback ist EncoderExceptionFallback festgelegt.EncoderFallback is set to EncoderExceptionFallback.

Hinweise

Um die genaue Array Größe zu berechnen, die GetBytes zum Speichern der resultierenden Bytes erfordert, verwendet die Anwendung GetByteCount.To calculate the exact array size that GetBytes requires to store the resulting bytes, the application uses GetByteCount. Um die maximale Array Größe zu berechnen, sollte die Anwendung GetMaxByteCountverwenden.To calculate the maximum array size, the application should use GetMaxByteCount. Die GetByteCount-Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die GetMaxByteCount-Methode im Allgemeinen schneller ausgeführt wird.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Sicherheit

SecurityCriticalAttribute
Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.Requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

Siehe auch

GetByteCount(Char[], Int32, Int32)

Berechnet die Anzahl der Bytes, die beim Codieren der Zeichen aus dem angegebenen Zeichenarray erzeugt werden.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

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

Parameter

chars
Char[]

Das Zeichenarray, das die zu codierenden Zeichen enthält.The character array containing the set of characters to encode.

index
Int32

Der Index des ersten zu codierenden Zeichens.The index of the first character to encode.

count
Int32

Die Anzahl der zu codierenden Zeichen.The number of characters to encode.

Gibt zurück

Die Anzahl der Bytes, die beim Codieren der angegebenen Zeichen erzeugt werden.The number of bytes produced by encoding the specified characters.

Ausnahmen

chars ist null(Nothing).chars is null (Nothing).

index oder count ist kleiner als 0 (null).index or count is less than zero.

- oder --or- index und count geben keinen gültigen Bereich in charsan.index and count do not denote a valid range in chars.

- oder --or- Die daraus resultierende Byteanzahl ist größer als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.The resulting number of bytes is greater than the maximum number that can be returned as an int.

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).A fallback occurred (for more information, see Character Encoding in .NET) - und --and- Für EncoderFallback ist EncoderExceptionFallback festgelegt.EncoderFallback is set to EncoderExceptionFallback.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetByteCount-Methode verwendet wird, um die Anzahl von Bytes zurückzugeben, die zum Codieren eines Arrays von Unicode-Zeichen erforderlich sind.The following code example demonstrates how to use the GetByteCount method to return the number of bytes required to encode an array of Unicode characters.

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

Hinweise

Um die genaue Array Größe zu berechnen, die GetBytes zum Speichern der resultierenden Bytes benötigt, verwendet die Anwendung GetByteCount.To calculate the exact array size required by GetBytes to store the resulting bytes, the application uses GetByteCount. Um die maximale Array Größe zu berechnen, sollte die Anwendung GetMaxByteCountverwenden.To calculate the maximum array size, the application should use GetMaxByteCount. Die GetByteCount-Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die GetMaxByteCount-Methode im Allgemeinen schneller ausgeführt wird.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Siehe auch

Gilt für: