Strings.StrConv(String, VbStrConv, Int32) Methode

Definition

Gibt eine wie angegeben 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. Der zu konvertierende String-Ausdruck.

Conversion
VbStrConv

Erforderlich. VbStrConv-Member. Der Enumerationswert, der den Typ der auszuführenden Konvertierung angibt.

LocaleID
Int32

Dies ist optional. Der LocaleID-Wert, wenn dieser sich vom LocaleID-Wert des Systems unterscheidet. (Der LocaleID-Wert des Systems ist der Standardwert.)

Gibt zurück

Eine wie angegeben konvertierte Zeichenfolge.

Attribute

Ausnahmen

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

Beispiele

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

Die Konstanten VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChineseVbStrConv.Katakana, und 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, auf 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, wenn die Zeichenfolge so bearbeitet wird, dass die Groß- und Kleinschreibungsänderungen für das Gebietsschema geeignet sind, in dem die Anwendung verwendet wird.

Wichtig

Wenn Ihre Anwendung Sicherheitsentscheidungen basierend auf dem Ergebnis eines Vergleichsvorgangs oder einer Änderung von Groß-/Kleinschreibung trifft, sollte der Vorgang die String.Compare-Methode verwenden und Ordinal oder OrdinalIgnoreCase für das comparisonType-Argument übergeben. Weitere Informationen finden Sie unter Auswirkungen von Kultur auf Zeichenfolgen in Visual Basic.

Die Conversion-Argumenteinstellungen lauten:

Enumerationselement BESCHREIBUNG
VbStrConv.None Führt keine Konvertierung aus.
VbStrConv.LinguisticCasing Verwendet linguistische Regeln für die Groß- und Kleinschreibung anstelle des Dateisystems (Standard). Nur gültig mit VbStrConv.UpperCase und VbStrConv.LowerCase .
VbStrConv.UpperCase Konvertiert die Zeichenfolge in Großbuchstaben.
VbStrConv.LowerCase Konvertiert die Zeichenfolge in Kleinbuchstaben.
VbStrConv.ProperCase Konvertiert den ersten Buchstaben jedes Worts in Zeichenfolge in Großbuchstaben.
VbStrConv.Wide * Konvertiert schmale Zeichen (halbe Breite) in der Zeichenfolge in breite Zeichen (voller Breite). Die Konvertierung kann die Normalisierungsform „C“ verwenden, auch wenn ein Eingabezeichen bereits die volle Breite aufweist. Die Zeichenfolge „は“, die bereits die volle Breite aufweist, wird beispielsweise zu „ば“ normalisiert. Weitere Informationen finden Sie unter Unicode normalization forms (Unicode-Normalisierungsformen).
VbStrConv.Narrow * Konvertiert breite Zeichen (voller Breite) in der Zeichenfolge in schmale Zeichen (halbe 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.

Hinweis

Diese Konstanten werden im .NET Framework Common Language Runtime 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. ), es sei denn, UpperCase + WideVbStrConv.Wide + VbStrConv.Narrowsie schließen sich gegenseitig aus (z. B. ).

Im Folgenden finden Sie gültige Worttrennzeichen für die korrekte Groß-/Kleinschreibung: Null (Chr$(0)), horizontale Registerkarte (Chr$(9)), Zeilenvorschub (Chr$(10)), vertikale Registerkarte (Chr$(11)), Formularvorschub (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