Strings.StrConv(String, VbStrConv, Int32) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Strings.vb

Quelle:: Strings.vb

Quelle:: Strings.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

Eine Zeichenfolge, die wie angegeben konvertiert wurde.

Attribute: SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

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:

Freigeben über