Die Funktionen "Asc" und "AscW"

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt einen Integer-Wert zurück, der den einem Zeichen entsprechenden Zeichencode darstellt.

Public Overloads Function Asc(ByVal String As Char) As Integer
Public Overloads Function AscW(ByVal String As Char) As Integer
' -or-
Public Overloads Function Asc(ByVal String As String) As Integer
Public Overloads Function AscW(ByVal String As String) As Integer

Parameter

String
Erforderlich. Ein beliebiger gültiger Char-Ausdruck oder String-Ausdruck. Wenn es sich bei String um einen String-Ausdruck handelt, wird für die Eingabe nur das erste Zeichen der Zeichenfolge verwendet. Wenn String den Wert Nothing hat oder keine Zeichen enthält, tritt ein ArgumentException-Fehler auf.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	String ist leer oder hat die Länge 0 (null).

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 Fehlerkontrolle durch Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Asc gibt den Codepunkt (Zeichencode) für das Eingabezeichen zurück. Für Einbyte-Zeichensätze (SBCS, Single-Byte Character Set) reichen die Werte von 0 bis 255, und für Doppelbyte-Zeichensätze (DBCS, Double-Byte Character Set) von –32768 bis 32767.

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.

AscW gibt den Unicode-Codepunkt für das Eingabezeichen zurück. Dieser kann im Bereich von 0 bis 65535 liegen. Der zurückgegebene Wert ist von den Einstellungen für Kultur und Codepage für den aktuellen Thread unabhängig.

Hinweis:
Die AscB-Funktion aus früheren Versionen von Visual Basic gibt einen Code für ein Byte zurück und nicht für ein Zeichen. Sie wird primär zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Ab Visual Basic 2005 haben Zeichenfolgen das Unicode-Format. AscB wird nicht mehr unterstützt.

Beispiel

In diesem Beispiel wird die Asc-Funktion dazu verwendet, Zeichencodes mit dem Integer-Datentyp (Visual Basic) zurückzugeben, die dem ersten Buchstaben in den einzelnen Zeichenfolgen entsprechen.

Dim codeInt As Integer
' The following line of code sets codeInt to 65.
codeInt = Asc("A")
' The following line of code sets codeInt to 97.
codeInt = Asc("a")
' The following line of code sets codeInt to 65.
codeInt = Asc("Apple")