Die Funktionen "Chr" und "ChrW"

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt das dem angegebenen Zeichencode zugeordnete Zeichen zurück.

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

Parameter

CharCode
Erforderlich. Ein Integer-Ausdruck, der den Codepunkt oder Zeichencode für das Zeichen darstellt. Wenn CharCode außerhalb des gültigen Bereichs liegt, tritt ein ArgumentException-Fehler auf. Der gültige Bereich für Chr ist 0 bis 255, und der gültige Bereich für ChrW ist -32768 bis 65535.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	CharCode < -32768 oder > 65535 für ChrW.
ArgumentException	5	CharCode < 0 oder > 255 für Chr.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Da CharCode einen asymmetrischen Bereich akzeptiert, werden die Speicherunterschiede zwischen dem Short-Datentyp (Visual Basic) und dem Integer-Datentyp (Visual Basic) ausgeglichen. Zum Beispiel ist -29183 ein Short-Datentyp, +36353 dagegen ein Integer-Datentyp. So wird auch Kompatibilität mit Visual Basic 6.0 geschaffen.

Chr bestimmt anhand der Encoding-Klasse im System.Text-Namespace, ob der aktuelle Thread auf einem Einzelbyte-Zeichensatz (SBCS) oder einem Doppelbyte-Zeichensatz (DBCS) beruht. Anschließend wird CharCode als Codepunkt im entsprechenden Satz übernommen. Bei SBCS-Zeichen liegt der mögliche Bereich zwischen 0 und 255 und bei DBCS-Zeichen zwischen -32768 und 65535.

Der zurückgegebene Wert hängt von der Codepage für den aktuellen Thread ab, die in der ANSICodePage-Eigenschaft der TextInfo-Klasse im System.Globalization-Namespace enthalten ist. Sie können ANSICodePage abrufen, indem Sie System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage angeben.

ChrW übernimmt CharCode als Unicode-Codepunkt. Der Bereich ist unabhängig von den Kultur- und Codepageeinstellungen des aktuellen Threads. Werte zwischen -32768 und -1 werden behandelt wie Werte im Bereich zwischen +32768 und +65535.

Die Zahlen von 0 bis 31 entsprechen den nicht darstellbaren ASCII-Standardcodes. Chr(10) gibt zum Beispiel ein Zeilenvorschubzeichen zurück.

Hinweis:
Die ChrB-Funktion in früheren Versionen von Visual Basic gibt ein einzelnes Byte zurück. Sie wird primär zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Alle Zeichenfolgen in Visual Basic und .NET-Framework haben das Unicode-Format, und ChrB wird nicht mehr unterstützt.

Beispiel

Im folgenden Beispiel dient die Chr-Funktion dazu, das Zeichen mit dem angegebenen Zeichencode zurückzugeben.

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