UTF7Encoding.GetByteCount Metodo
Definizione
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
| GetByteCount(String) |
Calcola il numero di byte prodotti dalla codifica dei caratteri nell'oggetto String specificato. |
| GetByteCount(Char*, Int32) |
Calcola il numero di byte prodotti dalla codifica di un set di caratteri a partire dal puntatore ai 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)
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
Calcola il numero di byte prodotti dalla codifica dei caratteri nell'oggetto String specificato.
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 -> intPublic Overrides Function GetByteCount (s As String) As IntegerParametri
Restituisce
Numero di byte prodotti dalla codifica dei caratteri specificati.
- Attributi
Eccezioni
s è null (Nothing).
Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.
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 usare il metodo per restituire il GetByteCount numero di byte necessari per codificare una matrice di caratteri.
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
Commenti
Per calcolare le dimensioni esatte 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 una quantità di memoria inferiore, mentre il GetMaxByteCount metodo viene in genere eseguito più velocemente.
Vedi anche
Si applica a
GetByteCount(Char*, Int32)
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
Importante
Questa API non è conforme a CLS.
Calcola il numero di byte prodotti dalla codifica di un set di caratteri a partire dal puntatore ai 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)]
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 -> intParametri
- chars
- Char*
Puntatore al primo carattere da codificare.
- count
- Int32
Numero di caratteri da codificare.
Restituisce
Numero di byte prodotti dalla codifica dei caratteri specificati.
- Attributi
Eccezioni
chars è null (Nothing in Visual Basic .NET).
count è minore di zero.
-oppure-
Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.
Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)
-e-
EncoderFallback è impostato su EncoderExceptionFallback.
Commenti
Per calcolare le dimensioni esatte 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 una quantità di memoria inferiore, mentre il GetMaxByteCount metodo viene in genere eseguito più velocemente.
Vedi anche
Si applica a
GetByteCount(Char[], Int32, Int32)
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
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 -> intPublic Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As IntegerParametri
- 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.
Restituisce
Numero di byte prodotti dalla codifica dei caratteri specificati.
Eccezioni
chars è null (Nothing).
index o count è minore di zero.
-oppure-
index e count non identificano un intervallo valido in chars.
-oppure-
Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.
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 usare il metodo per restituire il GetByteCount numero di byte necessari per codificare una matrice di caratteri 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
Commenti
Per calcolare le dimensioni esatte della matrice richieste 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 una quantità di memoria inferiore, mentre il GetMaxByteCount metodo viene in genere eseguito più velocemente.
