UTF7Encoding.GetByteCount Metodo

Definizione

Spazio dei nomi:: System.Text

Assembly:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Calcola il numero di byte prodotti dalla codifica di un set di caratteri.

Overload

Nome	Descrizione
GetByteCount(String)	Calcola il numero di byte prodotti dalla codifica dei caratteri nell'oggetto specificato String .
GetByteCount(Char*, Int32)	Calcola il numero di byte prodotti dalla codifica di un set di caratteri a partire dal puntatore di caratteri specificato.
GetByteCount(Char[], Int32, Int32)	Calcola il numero di byte prodotti dalla codifica di un set di caratteri dalla matrice di caratteri specificata.

GetByteCount(String)

Calcola il numero di byte prodotti dalla codifica dei caratteri nell'oggetto specificato String .

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

public override int GetByteCount(string s);

[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount(string s);

override this.GetByteCount : string -> int

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (s As String) As Integer

Parametri

s: String

Oggetto String contenente il set di caratteri da codificare.

Valori restituiti

Int32

Numero di byte prodotti dalla codifica dei caratteri specificati.

Attributi: ComVisibleAttribute

Eccezioni

ArgumentNullException

s è null (Nothing).

ArgumentOutOfRangeException

Il numero di byte risultante è maggiore del numero massimo che può essere restituito come int.

EncoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere codifica Caracter in .NET).

-e-

EncoderFallback è impostato su EncoderExceptionFallback.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il GetByteCount metodo per restituire il numero di byte necessari per codificare una matrice di caratteri.

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

Commenti

Per calcolare la dimensione esatta della matrice che GetBytes richiede di archiviare i byte risultanti, l'applicazione usa GetByteCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxByteCount. Il GetByteCount metodo in genere consente l'allocazione di meno memoria, mentre il GetMaxByteCount metodo viene generalmente eseguito più velocemente.

Vedi anche

Si applica a

GetByteCount(Char*, Int32)

Importante

Questa API non è conforme a CLS.

Calcola il numero di byte prodotti dalla codifica di un set di caratteri a partire dal puntatore di caratteri specificato.

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)]
[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)]
public override int GetByteCount(char* chars, int count);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

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

Parametri

chars: Char*

Puntatore al primo carattere da codificare.

count: Int32

Numero di caratteri da codificare.

Valori restituiti

Int32

Numero di byte prodotti dalla codifica dei caratteri specificati.

Attributi: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Eccezioni

ArgumentNullException

chars è null (Nothing in Visual Basic .NET).

ArgumentOutOfRangeException

count è minore di zero.

oppure

Il numero di byte risultante è maggiore del numero massimo che può essere restituito come int.

EncoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)

-e-

EncoderFallback è impostato su EncoderExceptionFallback.

Commenti

Vedi anche

Si applica a

GetByteCount(Char[], Int32, Int32)

Calcola il numero di byte prodotti dalla codifica di un set di caratteri dalla matrice di caratteri specificata.

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

Parametri

chars: Char[]

Matrice di caratteri contenente il set di caratteri da codificare.

index: Int32

Indice del primo carattere da codificare.

count: Int32

Numero di caratteri da codificare.

Valori restituiti

Int32

Numero di byte prodotti dalla codifica dei caratteri specificati.

Eccezioni

ArgumentNullException

chars è null (Nothing).

ArgumentOutOfRangeException

index o count è minore di zero.

oppure

index e count non indicano un intervallo valido in chars.

oppure

Il numero di byte risultante è maggiore del numero massimo che può essere restituito come int.

EncoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)

-e-

EncoderFallback è impostato su EncoderExceptionFallback.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il GetByteCount metodo per restituire il numero di byte necessari per codificare una matrice di caratteri Unicode.

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

Commenti

Per calcolare la dimensione esatta della matrice richiesta da GetBytes per archiviare i byte risultanti, l'applicazione usa GetByteCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxByteCount. Il GetByteCount metodo in genere consente l'allocazione di meno memoria, mentre il GetMaxByteCount metodo viene generalmente eseguito più velocemente.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?