StrConv-Funktion

Aktualisiert: November 2007

Gibt eine wie angegeben konvertierte Zeichenfolge zurück.

Public Shared Function StrConv( _
   ByVal str As String, _
   ByVal Conversion As Microsoft.VisualBasic.VbStrConv, _
   Optional ByVal LocaleID As Integer, 
) As String

Parameter

• str
  Erforderlich. Zu konvertierender String-Ausdruck.

• Conversion
  Erforderlich. VbStrConv-Enumeration-Member. Der Enumerationswert, mit dem der gewünschte Konvertierungstyp angegeben wird.

• LocaleID
  Optional. Der LocaleID-Wert, falls dieser sich vom aktuellen Kulturwert der Anwendung unterscheidet. Weitere Informationen über Gebietsschema-IDs und Kulturinformationen finden Sie unter CultureInfo. (Der aktuelle Kulturwert der Anwendung ist die Standardeinstellung.)

Einstellungen

Die Einstellungen für das Conversion-Argument sind:

^* Betrifft asiatische Gebietsschemas.

^**   Betrifft nur japanisches Gebietsschema.

Hinweis:
Diese Konstanten werden in der Common Language Runtime von .NET Framework angegeben. Dementsprechend können sie überall im Code anstelle der tatsächlichen Werte verwendet werden. Die meisten Konstanten können kombiniert werden (z. B. UpperCase + Wide). Dies ist allerdings nicht möglich, wenn sie sich gegenseitig ausschließen (z. B. VbStrConv.Wide + VbStrConv.Narrow).

Im Folgenden werden die gültigen Worttrennzeichen für eine richtige Groß-/Kleinschreibung genannt: NULL (Chr$(0)), horizontaler Tabulator (Chr$(9)), Zeilenvorschub (Chr$(10)), vertikaler Tabulator (Chr$(11)), Seitenvorschub (Chr$(12)), Wagenrücklauf (Chr$(13)), Leerzeichen (Einzelbyte-Zeichensatz) (Chr$(32)). Der tatsächliche Wert für ein Leerzeichen (volle oder halbe Breite) ist für fernöstliche Kulturen je nach Land/Region unterschiedlich.

Ausnahmen

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

Wenn die Konstanten VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana und VbStrConv.Hiragana in Gebietsschemas angewendet werden, in denen sie nicht gültig sind, können Laufzeitfehler auftreten. Dies ist jedoch nicht immer der Fall. Die Konstanten VbStrConv.Katakana und VbStrConv.Hiragana können auch in anderen Gebietsschemas als dem japanischen verwendet werden, sofern das Sprachpaket für Japanisch installiert ist. Darüber hinaus werden die Konstanten VbStrConv.Wide und VbStrConv.Narrow auf allen Systemen unterstützt, auf denen eine fernöstliche Sprache installiert ist.

Diese Funktion verwendet die Kulturinformationen der Anwendung beim Bearbeiten der Zeichenfolge, sodass die Änderungen der Groß- und Kleinschreibung dem Gebietsschema entsprechen, in dem die Anwendung verwendet wird.

Sicherheitshinweis:
Wenn die Anwendung Sicherheitsentscheidungen aufgrund der Ergebnisse einer Vergleichsoperation oder einer Operation zum Ändern der Groß-/Kleinschreibung durchführt, sollte die Operation die String.Compare-Methode verwenden und als comparisonType-Argument Ordinal oder OrdinalIgnoreCase übergeben. Weitere Informationen finden Sie unter Auswirkungen der Kultur auf Zeichenfolgen in Visual Basic.

Beispiel

In diesem Beispiel wird Text in Kleinbuchstaben konvertiert.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

Hinweise für Entwickler intelligenter Geräte

Diese Funktion wird nicht unterstützt.

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

Zeichenfolgenbearbeitung: Zusammenfassung

Die Funktionen "Chr" und "ChrW"

String-Datentyp (Visual Basic)

Funktionen für die Typkonvertierung

ArgumentException