Strings.StrConv(String, VbStrConv, Int32) Methode

Definition

Gibt eine wie angegebene Zeichenfolge konvertierte Zeichenfolge zurück.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Parameter

str
String

Erforderlich. String Ausdruck, der konvertiert werden soll.

Conversion
VbStrConv

Erforderlich. VbStrConv Mitglied. Der Enumerationswert, der den auszuführenden Konvertierungstyp angibt.

LocaleID
Int32

Wahlfrei. Der LocaleID Wert, wenn sich der Wert vom System LocaleID unterscheidet. (Der System-LocaleID-Wert ist der Standardwert.)

Gibt zurück

Eine Zeichenfolge, die wie angegeben konvertiert wurde.

Attribute

Ausnahmen

Nicht unterstützte LocaleID, Conversion< 0 oder > 2048 oder nicht unterstützte Konvertierung für das angegebene Gebietsschema.

Beispiele

In diesem Beispiel werden Text in alle Kleinbuchstaben konvertiert.

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

Hinweise

Die Konstanten VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanaund VbStrConv.Hiragana können Laufzeitfehler verursachen, wenn sie in Gebietsschemas verwendet werden, in denen sie nicht angewendet werden, aber nicht immer: Die Konstanten VbStrConv.Katakana und VbStrConv.Hiragana können in einem nicht japanischen System verwendet werden, bei dem das japanische Sprachpaket installiert ist. Darüber hinaus wird die Verwendung der Konstanten VbStrConv.Wide und VbStrConv.Narrow auf jedem System unterstützt, auf dem eine ostasiatische Sprache installiert ist.

Diese Funktion verwendet die Kulturinformationen der Anwendung beim Bearbeiten der Zeichenfolge, sodass die Falländerungen für das Gebietsschema geeignet sind, in dem die Anwendung verwendet wird.

Wichtig

Wenn Ihre Anwendung Sicherheitsentscheidungen basierend auf dem Ergebnis eines Vergleichs- oder Falländerungsvorgangs trifft, sollte der Vorgang die String.Compare-Methode verwenden und Ordinal oder OrdinalIgnoreCase für das argument comparisonType übergeben. Weitere Informationen finden Sie unter Wie Kultur sich auf Zeichenfolgen in Visual Basicauswirkt.

Die Conversion Argumenteinstellungen sind:

Enumerationselement Beschreibung
VbStrConv.None Führt keine Konvertierung durch.
VbStrConv.LinguisticCasing Verwendet linguistische Regeln für die Groß-/Kleinschreibung anstelle des Dateisystems (Standard). Gültig nur für VbStrConv.UpperCase und VbStrConv.LowerCase.
VbStrConv.UpperCase Konvertiert die Zeichenfolge in Großbuchstaben.
VbStrConv.LowerCase Konvertiert die Zeichenfolge in Kleinbuchstaben.
VbStrConv.ProperCase Wandelt den ersten Buchstaben jedes Worts in Zeichenfolge in Großbuchstaben um.
VbStrConv.Wide * Wandelt schmale Zeichen (halbbreite) in die Zeichenfolge in breite Zeichen (volle Breite) um. Die Konvertierung kann Normalisierungsformular C auch dann verwenden, wenn ein Eingabezeichen bereits vollbreite ist. Beispielsweise wird die Zeichenfolge "は ゙" (die bereits vollbreite ist) in "ば" normalisiert. Siehe Unicode-Normalisierungsformulare.
VbStrConv.Narrow * Konvertiert breite Zeichen in der Zeichenfolge in schmale Zeichen (halber Breite).
VbStrConv.Katakana ** Konvertiert Hiragana-Zeichen in der Zeichenfolge in Katakana-Zeichen.
VbStrConv.Hiragana ** Konvertiert Katakana-Zeichen in der Zeichenfolge in Hiragana-Zeichen.
VbStrConv.SimplifiedChinese * Konvertiert traditionelle chinesische Zeichen in vereinfachtes Chinesisch.
VbStrConv.TraditionalChinese * Konvertiert vereinfachte chinesische Zeichen in traditionelles Chinesisch.

* gilt für asiatische Gebietsschemas.

** gilt nur für Japan.

Anmerkung

Diese Konstanten werden in der Common Language Runtime von .NET Framework angegeben. Daher können sie an einer beliebigen Stelle im Code anstelle der tatsächlichen Werte verwendet werden. Die meisten können kombiniert werden (z. B. UpperCase + Wide), außer wenn sie sich gegenseitig ausschließen (z. B. VbStrConv.Wide + VbStrConv.Narrow).

Es folgen gültige Worttrennzeichen für die richtige Groß-/Kleinschreibung: Null (Chr$(0)), horizontale Tabstopp (Chr$(9)), Zeilenvorschub (Chr$(10)), vertikale Registerkarte (Chr$(11)), Formularfeed (Chr$(12)), Wagenrücklauf (Chr$(13)), Leerzeichen (Ein-Byte-Zeichensatz) (Chr$(32)). Der tatsächliche Wert für einen Raum, der voll oder halb breit sein kann, variiert je nach Land/Region für ostasiatische Kulturen.

Gilt für:

Weitere Informationen