UnicodeEncoding.GetBytes Metod

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.Text.Encoding.Extensions.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Kodar en uppsättning tecken i en sekvens med byte.

Överlagringar

Name	Description
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Kodar en uppsättning tecken från den angivna teckenmatrisen till den angivna bytematrisen.
GetBytes(String, Int32, Int32, Byte[], Int32)	Kodar en uppsättning tecken från den angivna String i den angivna bytematrisen.
GetBytes(String)	Kodar en uppsättning tecken från den angivna strängen till den angivna bytematrisen.
GetBytes(Char, Int32, Byte, Int32)	Kodar en uppsättning tecken som börjar vid den angivna teckenpekaren till en sekvens med byte som lagras från och med den angivna bytepekaren.

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Kodar en uppsättning tecken från den angivna teckenmatrisen till den angivna bytematrisen.

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

Parametrar

chars: Char[]

Teckenmatrisen som innehåller den uppsättning tecken som ska kodas.

charIndex: Int32

Indexet för det första tecknet som ska kodas.

charCount: Int32

Antalet tecken som ska kodas.

bytes: Byte[]

Bytematrisen som ska innehålla den resulterande sekvensen av byte.

byteIndex: Int32

Indexet där du ska börja skriva den resulterande sekvensen med byte.

Returer

Int32

Det faktiska antalet byte som skrivits till bytes.

Undantag

ArgumentNullException

chars är null (Nothing).

-eller-

bytes är null (Nothing).

ArgumentOutOfRangeException

charIndex eller charCountbyteIndex är mindre än noll.

-eller-

charIndex och charCount ange inte ett giltigt intervall i chars.

-eller-

byteIndex är inte ett giltigt index i bytes.

ArgumentException

Felidentifiering är aktiverat och chars innehåller en ogiltig teckensekvens.

-eller-

bytes har inte tillräckligt med kapacitet från byteIndex till slutet av matrisen för att rymma de resulterande byteen.

EncoderFallbackException

En reserv inträffade (mer information finns i Character Encoding i .NET)

-och-

EncoderFallback är inställt på EncoderExceptionFallback.

Exempel

I följande exempel visas hur du använder GetBytes metoden för att koda ett intervall med tecken från en String och lagra kodade byte i ett område med element i en bytematris.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "Unicode Encoding Example";
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars.ToCharArray(), 8, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 8, 8, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "Unicode Encoding Example"
        
        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars.ToCharArray(), 8, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 8, 8, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", 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

Kommentarer

Om du vill beräkna den exakta matrisstorlek som krävs för GetBytes att lagra de resulterande byteen GetByteCount anropar du metoden. Om du vill beräkna den maximala matrisstorleken GetMaxByteCount anropar du metoden. Metoden GetByteCount allokerar vanligtvis mindre minne, medan GetMaxByteCount metoden vanligtvis körs snabbare.

Med felidentifiering orsakar en ogiltig sekvens att den här metoden genererar en ArgumentException. Utan felidentifiering ignoreras ogiltiga sekvenser och inget undantag utlöses.

Data som ska konverteras, till exempel data som lästs från en dataström, kan endast vara tillgängliga i sekventiella block. I det här fallet, eller om mängden data är så stor att den måste delas upp i mindre block, bör programmet använda Decoder eller som Encoder tillhandahålls av GetDecoder metoden eller GetEncoder metoden.

Important

För att säkerställa att de kodade byteen avkodas korrekt när de sparas som en fil eller som en ström, kan du prefixa en ström med kodade byte med en ingress. Utvecklaren ansvarar för att infoga ingressen i början av en byteström (till exempel i början av en serie byte som ska skrivas till en fil). Metoden GetBytes förbereder inte en ingress till början av en sekvens med kodade byte.

Se även

Gäller för

GetBytes(String, Int32, Int32, Byte[], Int32)

Kodar en uppsättning tecken från den angivna String i den angivna bytematrisen.

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);

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

Parametrar

s: String

Strängen som innehåller den uppsättning tecken som ska kodas.

charIndex: Int32

Indexet för det första tecknet som ska kodas.

charCount: Int32

Antalet tecken som ska kodas.

bytes: Byte[]

Bytematrisen som ska innehålla den resulterande sekvensen av byte.

byteIndex: Int32

Indexet där du ska börja skriva den resulterande sekvensen med byte.

Returer

Int32

Det faktiska antalet byte som skrivits till bytes.

Undantag

ArgumentNullException

s är null.

-eller-

bytes är null (Nothing).

ArgumentOutOfRangeException

charIndex eller charCountbyteIndex är mindre än noll.

-eller-

charIndex och charCount ange inte ett giltigt intervall i s.

-eller-

byteIndex är inte ett giltigt index i bytes.

ArgumentException

Felidentifiering är aktiverat och s innehåller en ogiltig teckensekvens.

-eller-

bytes har inte tillräckligt med kapacitet från byteIndex till slutet av matrisen för att rymma de resulterande byteen.

EncoderFallbackException

En reserv inträffade (mer information finns i Character Encoding i .NET)

-och-

EncoderFallback är inställt på EncoderExceptionFallback.

Exempel

I följande exempel visas hur du kodar ett område med element från en Unicode-teckenmatris och lagrar kodade byte i ett intervall med element i en bytematris.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.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 UnicodeEncodingExample
    
    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 uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.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

Kommentarer

Med felidentifiering orsakar en ogiltig sekvens att den här metoden genererar en ArgumentException. Utan felidentifiering ignoreras ogiltiga sekvenser och inget undantag utlöses.

Important

Se även

Gäller för

GetBytes(String)

Kodar en uppsättning tecken från den angivna strängen till den angivna bytematrisen.

public:
 override cli::array <System::Byte> ^ GetBytes(System::String ^ s);

public override byte[] GetBytes(string s);

override this.GetBytes : string -> byte[]

Public Overrides Function GetBytes (s As String) As Byte()

Parametrar

s: String

Returer

Byte[]

Gäller för

GetBytes(Char, Int32, Byte, Int32)

Viktigt!

Detta API uppfyller inte CLS.

Kodar en uppsättning tecken som börjar vid den angivna teckenpekaren till en sekvens med byte som lagras från och med den angivna bytepekaren.

public:
 override int GetBytes(char* chars, int charCount, System::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.Runtime.InteropServices.ComVisible(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)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(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

Parametrar

chars: Char*

En pekare till det första tecknet som ska kodas.

charCount: Int32

Antalet tecken som ska kodas.

bytes: Byte*

En pekare till den plats där du ska börja skriva den resulterande sekvensen med byte.

byteCount: Int32

Det maximala antalet byte som ska skrivas.

Returer

Int32

Det faktiska antalet byte som skrivits på den plats som anges av parametern bytes .

Attribut: CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

chars är null (Nothing).

-eller-

bytes är null (Nothing).

ArgumentOutOfRangeException

charCount eller byteCount är mindre än noll.

ArgumentException

Felidentifiering är aktiverat och chars innehåller en ogiltig teckensekvens.

-eller-

byteCount är mindre än det resulterande antalet byte.

EncoderFallbackException

En reserv inträffade (mer information finns i Character Encoding i .NET)

-och-

EncoderFallback är inställt på EncoderExceptionFallback.

Kommentarer

Om du vill beräkna den exakta matrisstorlek som GetBytes krävs för att lagra de resulterande byteen GetByteCount anropar du metoden. Om du vill beräkna den maximala matrisstorleken GetMaxByteCount anropar du metoden. Metoden GetByteCount allokerar vanligtvis mindre minne, medan GetMaxByteCount metoden vanligtvis körs snabbare.

Med felidentifiering orsakar en ogiltig sekvens att den här metoden genererar en ArgumentException. Utan felidentifiering ignoreras ogiltiga sekvenser och inget undantag utlöses.

Data som ska konverteras, till exempel data som lästs från en dataström, kan endast vara tillgängliga i sekventiella block. I det här fallet, eller om mängden data är så stor att den måste delas upp i mindre block, bör programmet använda Decoder eller - Encoder objektet som tillhandahålls av GetDecoder metoden eller GetEncoder .

Important

Se även

Gäller för

Feedback

Var den här sidan till hjälp?

UnicodeEncoding.GetBytes Metod

Definition

Överlagringar

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Parametrar

Returer

Undantag

Exempel

Kommentarer

Se även

Gäller för

GetBytes(String, Int32, Int32, Byte[], Int32)

Parametrar

Returer

Undantag

Exempel

Kommentarer

Se även

Gäller för

GetBytes(String)

Parametrar

Returer

Gäller för

GetBytes(Char*, Int32, Byte*, Int32)

Parametrar

Returer

Undantag

Kommentarer

Se även

Gäller för

Feedback

GetBytes(Char, Int32, Byte, Int32)