UTF7Encoding.GetBytes Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Koduje zestaw znaków w sekwencji bajtów.
Przeciążenia
GetBytes(Char*, Int32, Byte*, Int32) |
Koduje zestaw znaków rozpoczynający się od określonego wskaźnika znaku do sekwencji bajtów przechowywanych w określonym wskaźniku bajtów. |
GetBytes(Char[], Int32, Int32, Byte[], Int32) |
Koduje zestaw znaków z określonej tablicy znaków do określonej tablicy bajtów. |
GetBytes(String, Int32, Int32, Byte[], Int32) |
Koduje zestaw znaków z określonej String tablicy bajtów. |
GetBytes(Char*, Int32, Byte*, Int32)
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją CLS.
Koduje zestaw znaków rozpoczynający się od określonego wskaźnika znaku do sekwencji bajtów przechowywanych w określonym wskaźniku bajtów.
public:
override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
Parametry
- chars
- Char*
Wskaźnik do pierwszego znaku w celu zakodowania.
- charCount
- Int32
Liczba znaków do zakodowania.
- bytes
- Byte*
Wskaźnik do lokalizacji, w której należy rozpocząć pisanie wynikowej sekwencji bajtów.
- byteCount
- Int32
Maksymalna liczba bajtów do zapisu.
Zwraca
Rzeczywista liczba bajtów zapisanych w lokalizacji wskazanej przez bytes
.
- Atrybuty
Wyjątki
charCount
wartość lub byteCount
jest mniejsza niż zero.
byteCount
jest mniejsza niż wynikowa liczba bajtów.
Wystąpił powrót (zobacz Kodowanie znaków na platformie .NET, aby uzyskać bardziej szczegółowe wyjaśnienie).
-I-
EncoderFallback parametr jest ustawiony na EncoderExceptionFallbackwartość .
Uwagi
Aby obliczyć dokładny rozmiar tablicy wymagany przez GetBytes program do przechowywania wynikowych bajtów, aplikacja używa elementu GetByteCount. Aby obliczyć maksymalny rozmiar tablicy, aplikacja powinna używać polecenia GetMaxByteCount. Metoda GetByteCount zwykle zezwala na alokację mniejszej ilości pamięci, podczas gdy GetMaxByteCount metoda zwykle wykonuje się szybciej.
Dane do przekonwertowania, takie jak dane odczytywane ze strumienia, mogą być dostępne tylko w blokach sekwencyjnych. W takim przypadku lub jeśli ilość danych jest tak duża, że musi być podzielona na mniejsze bloki, aplikacja powinna używać Decoder wartości lub dostarczonej GetDecoder przez metodę lub EncoderGetEncoder metodę.
Uwaga
UTF7Encoding nie zapewnia wykrywania błędów. Nieprawidłowe znaki są kodowane jako zmodyfikowany znak podstawowy 64. Ze względów bezpieczeństwa zaleca się korzystanie z UTF8Encodingaplikacji , UnicodeEncodinglub UTF32Encoding i włączanie wykrywania błędów.
Zobacz też
Dotyczy
GetBytes(Char[], Int32, Int32, Byte[], Int32)
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
Koduje zestaw znaków z określonej tablicy znaków do określonej tablicy bajtów.
public:
override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : char[] * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer
Parametry
- chars
- Char[]
Tablica znaków zawierająca zestaw znaków do kodowania.
- charIndex
- Int32
Indeks pierwszego znaku do zakodowania.
- charCount
- Int32
Liczba znaków do zakodowania.
- bytes
- Byte[]
Tablica bajtów zawierająca wynikową sekwencję bajtów.
- byteIndex
- Int32
Indeks, na którym należy rozpocząć pisanie wynikowej sekwencji bajtów.
Zwraca
Rzeczywista liczba bajtów zapisanych w pliku bytes
.
Wyjątki
charIndex
lub charCount
byteIndex
jest mniejsza niż zero.
-lub-
charIndex
i charCount
nie oznaczają prawidłowego zakresu w elemecie chars
.
-lub-
byteIndex
nie jest prawidłowym indeksem w pliku bytes
.
bytes
nie ma wystarczającej pojemności od byteIndex
do końca tablicy, aby pomieścić wynikowe bajty.
Wystąpił powrót (zobacz Kodowanie znaków na platformie .NET, aby uzyskać bardziej szczegółowe wyjaśnienie).
-I-
EncoderFallback parametr jest ustawiony na EncoderExceptionFallbackwartość .
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą GetBytes metody kodować zakres znaków z obiektu String i przechowywać zakodowane bajty w zakresie elementów w tablicy bajtów.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Byte>^bytes;
// 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 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf7->GetBytes( chars, 1, 2, bytes, 0 );
Console::WriteLine( "{0} bytes used to encode characters.", bytesEncodedCount );
Console::Write( "Encoded bytes: " );
IEnumerator^ myEnum = bytes->GetEnumerator();
while ( myEnum->MoveNext() )
{
Byte b = safe_cast<Byte>(myEnum->Current);
Console::Write( "[{0}]", b );
}
Console::WriteLine();
}
using System;
using System.Text;
class UTF7EncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = utf7.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf7.GetBytes(chars, 1, 2, bytes, 0);
Console.WriteLine(
"{0} bytes used to encode characters.", bytesEncodedCount
);
Console.Write("Encoded bytes: ");
foreach (Byte b in bytes) {
Console.Write("[{0}]", b);
}
Console.WriteLine();
}
}
Imports System.Text
Imports Microsoft.VisualBasic.strings
Class UTF7EncodingExample
Public Shared Sub Main()
Dim bytes() As Byte
' 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)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf7.GetBytes(chars, 1, 2, bytes, 0)
Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
Console.Write("Encoded bytes: ")
Dim b As Byte
For Each b In bytes
Console.Write("[{0}]", b)
Next b
Console.WriteLine()
End Sub
End Class
Uwagi
Aby obliczyć dokładny rozmiar tablicy wymagany przez GetBytes program do przechowywania wynikowych bajtów, aplikacja używa elementu GetByteCount. Aby obliczyć maksymalny rozmiar tablicy, aplikacja powinna używać polecenia GetMaxByteCount. Metoda GetByteCount zwykle zezwala na alokację mniejszej ilości pamięci, podczas gdy GetMaxByteCount metoda zwykle wykonuje się szybciej.
Dane do przekonwertowania, takie jak dane odczytywane ze strumienia, mogą być dostępne tylko w blokach sekwencyjnych. W takim przypadku lub jeśli ilość danych jest tak duża, że musi być podzielona na mniejsze bloki, aplikacja powinna używać Decoder wartości lub dostarczonej GetDecoder przez metodę lub EncoderGetEncoder metodę.
Uwaga
UTF7Encoding nie zapewnia wykrywania błędów. Nieprawidłowe znaki są kodowane jako zmodyfikowany znak podstawowy 64. Ze względów bezpieczeństwa zaleca się korzystanie z UTF8Encodingaplikacji , UnicodeEncodinglub UTF32Encoding i włączanie wykrywania błędów.
Zobacz też
Dotyczy
GetBytes(String, Int32, Int32, Byte[], Int32)
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
- Źródło:
- UTF7Encoding.cs
Koduje zestaw znaków z określonej String tablicy bajtów.
public:
override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : string * int * int * byte[] * int -> int
Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer
Parametry
- charIndex
- Int32
Indeks pierwszego znaku do zakodowania.
- charCount
- Int32
Liczba znaków do zakodowania.
- bytes
- Byte[]
Tablica bajtów zawierająca wynikową sekwencję bajtów.
- byteIndex
- Int32
Indeks, na którym należy rozpocząć pisanie wynikowej sekwencji bajtów.
Zwraca
Rzeczywista liczba bajtów zapisanych w pliku bytes
.
- Atrybuty
Wyjątki
charIndex
lub charCount
byteIndex
jest mniejsza niż zero.
-lub-
charIndex
i charCount
nie oznaczają prawidłowego zakresu w elemecie chars
.
-lub-
byteIndex
nie jest prawidłowym indeksem w pliku bytes
.
bytes
nie ma wystarczającej pojemności od byteIndex
do końca tablicy, aby pomieścić wynikowe bajty.
Wystąpił powrót (zobacz Kodowanie znaków na platformie .NET, aby uzyskać bardziej szczegółowe wyjaśnienie).
-I-
EncoderFallback parametr jest ustawiony na EncoderExceptionFallbackwartość .
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą GetBytes metody kodować szereg elementów z tablicy znaków Unicode i przechowywać zakodowane bajty w zakresie elementów w tablicy bajtów.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Byte>^bytes;
// 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 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf7->GetBytes( chars, 1, 2, bytes, 0 );
Console::WriteLine( "{0} bytes used to encode characters.", bytesEncodedCount );
Console::Write( "Encoded bytes: " );
IEnumerator^ myEnum = bytes->GetEnumerator();
while ( myEnum->MoveNext() )
{
Byte b = safe_cast<Byte>(myEnum->Current);
Console::Write( "[{0}]", b );
}
Console::WriteLine();
}
using System;
using System.Text;
class UTF7EncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = utf7.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf7.GetBytes(chars, 1, 2, bytes, 0);
Console.WriteLine(
"{0} bytes used to encode characters.", bytesEncodedCount
);
Console.Write("Encoded bytes: ");
foreach (Byte b in bytes) {
Console.Write("[{0}]", b);
}
Console.WriteLine();
}
}
Imports System.Text
Imports Microsoft.VisualBasic.strings
Class UTF7EncodingExample
Public Shared Sub Main()
Dim bytes() As Byte
' 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)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf7.GetBytes(chars, 1, 2, bytes, 0)
Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
Console.Write("Encoded bytes: ")
Dim b As Byte
For Each b In bytes
Console.Write("[{0}]", b)
Next b
Console.WriteLine()
End Sub
End Class
Uwagi
Aby obliczyć dokładny rozmiar tablicy wymagany przez GetBytes program do przechowywania wynikowych bajtów, aplikacja używa elementu GetByteCount. Aby obliczyć maksymalny rozmiar tablicy, aplikacja powinna używać polecenia GetMaxByteCount. Metoda GetByteCount zwykle zezwala na alokację mniejszej ilości pamięci, podczas gdy GetMaxByteCount metoda zwykle wykonuje się szybciej.
Dane do przekonwertowania, takie jak dane odczytywane ze strumienia, mogą być dostępne tylko w blokach sekwencyjnych. W takim przypadku lub jeśli ilość danych jest tak duża, że musi być podzielona na mniejsze bloki, aplikacja powinna używać Decoder wartości lub dostarczonej GetDecoder przez metodę lub EncoderGetEncoder metodę.
Uwaga
UTF7Encoding nie zapewnia wykrywania błędów. Nieprawidłowe znaki są kodowane jako zmodyfikowany znak podstawowy 64. Ze względów bezpieczeństwa zaleca się korzystanie z UTF8Encodingaplikacji , UnicodeEncodinglub UTF32Encoding i włączanie wykrywania błędów.
Zobacz też
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla