UnicodeEncoding.GetChars 方法

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

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

參數

傳回

參數所示 chars 位置實際寫入的字元數。

屬性

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

例外狀況

備註

為了計算儲存所得字元所需的精確陣列大小 GetChars ，應用程式使用 GetCharCount。 要計算最大陣列大小，應用程式應使用 GetMaxCharCount。 此 GetCharCount 方法通常分配較少記憶體，而 GetMaxCharCount 執行速度較快。

在錯誤檢測中，若序列無效，該方法會拋出 ArgumentException。 若無錯誤偵測，無效序列會被忽略，且不會拋出例外。

若解碼的位元組範圍包含位元組順序標記（BOM），且位元組陣列是由非 BOM 識別型態的方法回傳，則字元 U+FFFE 會包含在該方法回傳的字元陣列中。 你可以透過呼叫 String.TrimStart 該方法來移除它。

待轉換的資料，例如從串流讀取的資料，可能只能以連續區塊形式取得。 在這種情況下，或資料量過大需要分割成較小區塊時，應用程式應分別使用 Decoder 或 Encoder 或 方法所提供的GetDecoderGetEncoder物件。

另請參閱

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public override int GetChars(byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

override this.GetChars : byte[] * int * int * char[] * int -> int

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

參數

傳回

實際寫入 chars的字元數。

例外狀況

範例

以下範例示範如何使用此 GetChars 方法解碼位元組陣列中的元素範圍，並將結果儲存在字元陣列中。

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();

        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = Unicode.GetChars(bytes, 2, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = uni.GetChars(bytes, 2, 8, chars, 0)
        
        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

備註

為了計算儲存所得字元所需的 GetChars 精確陣列大小，應用程式使用 GetCharCount。 要計算最大陣列大小，應用程式應使用 GetMaxCharCount。 此 GetCharCount 方法通常分配較少記憶體，而 GetMaxCharCount 執行速度較快。

在錯誤檢測中，若序列無效，該方法會拋出 ArgumentException。 若無錯誤偵測，無效序列會被忽略，且不會拋出例外。

若解碼的位元組範圍包含位元組順序標記（BOM），且位元組陣列是由非 BOM 識別型態的方法回傳，則字元 U+FFFE 會包含在該方法回傳的字元陣列中。 你可以透過呼叫 String.TrimStart 該方法來移除它。

待轉換的資料，例如從串流讀取的資料，可能只能以連續區塊形式取得。 在這種情況下，或資料量龐大到需要分割成較小區塊時，應用程式應分別使用DecoderEncoder方法或GetEncoder方法所提供的GetDecoder。

另請參閱

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)