Chr、ChrW 函式

發行項
08/21/2008

更新：2007 年 11 月

傳回與指定字元碼關聯的字元。

Public Function Chr(ByVal CharCode As Integer) As Char
Public Function ChrW(ByVal CharCode As Integer) As Char

參數

CharCode
必要項。代表字元的「字碼指標」或字元碼的 Integer 運算式。如果 CharCode 不在有效範圍內，則會發生 ArgumentException 錯誤。Chr 的有效範圍是 0 到 255，而 ChrW 的有效範圍是 -32768 到 65535。

例外狀況

例外狀況類型	錯誤代碼	條件
ArgumentException	5	ChrW 的 CharCode < -32768 或 > 65535。
ArgumentException	5	Chr 的 CharCode < 0 或 > 255。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀取代這類錯誤控制項。

備註

CharCode 接受的非對稱範圍可彌補 Short 資料型別 (Visual Basic) 和 Integer 資料型別 (Visual Basic) 之間的儲存區差異。例如，-29183 是 Short，但 +36353 是 Integer。這也有助於 Visual Basic 6.0 相容性。

Chr 使用 System.Text 命名空間中的 Encoding 類別，以判斷目前的執行緒是使用單一位元組字元集 (SBCS) 還是雙位元組字元集 (DBCS)。然後它會將 CharCode 當做適當字元集中的字碼指標。SBCS 字元的範圍是 0 到 255，DBCS 字元的範圍是 -32768 到 65535。

傳回值是取決於目前執行緒的字碼頁 (Code Page)，而該字碼頁會包含在 System.Globalization 命名空間中 TextInfo 類別的 ANSICodePage 屬性 (Property) 中。指定 System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage，即可取得 ANSICodePage。

ChrW 會採用 CharCode 做為 Unicode 字碼指標。這個範圍與目前執行緒的文化特性和字碼頁設定無關。-32768 到 -1 範圍中的數值與 +32768 到 +65535 範圍中的數值處理方式相同。

從 0 至 31 的數字與標準且不可列印的 ASCII 碼相同。例如，Chr(10) 會傳回換行字元。

注意事項：
舊版 Visual Basic 中的 ChrB 函式會傳回單一位元組。這項功能主要用來轉換雙位元組字元集 (DBCS) 應用程式中的字串。所有 Visual Basic 和 .NET Framework 中的字串都是 Unicode，而且不再支援 ChrB。

範例

下列範例會使用 Chr 函式，傳回與指定字元碼關聯的字元。

Dim associatedChar As Char
' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)