Strings.StrConv(String, VbStrConv, Int32) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.Core.dll
Zestaw:
Microsoft.VisualBasic.dll
Źródło:
Strings.vb
Źródło:
Strings.vb
Źródło:
Strings.vb

Zwraca ciąg przekonwertowany zgodnie z określoną wartością.

[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

Parametry

str
String

Wymagane. String wyrażenie, które ma zostać przekonwertowane.

Conversion
VbStrConv

Wymagane. VbStrConv Członkowskich. Wartość wyliczenia określająca typ konwersji do wykonania.

LocaleID
Int32

Opcjonalny. Wartość LocaleID , jeśli różni się od wartości systemowej LocaleID . (Wartość systemowa LocaleID jest wartością domyślną).

Zwraca

String

Ciąg przekonwertowany zgodnie z określoną wartością.

Atrybuty
SupportedOSPlatformAttribute

Wyjątki

ArgumentException

Nieobsługiwana LocaleIDkonwersja , Conversion< 0 lub > 2048 lub nieobsługiwana dla określonych ustawień regionalnych.

Przykłady

W tym przykładzie tekst jest konwertowany na wszystkie małe litery.

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

Uwagi

Stałe VbStrConv.Wide, , VbStrConv.KatakanaVbStrConv.TraditionalChineseVbStrConv.NarrowVbStrConv.SimplifiedChinesei VbStrConv.Hiragana mogą powodować błędy czasu wykonywania, gdy są używane w ustawieniach regionalnych, w których nie mają zastosowania, ale nie zawsze: stałe VbStrConv.Katakana i VbStrConv.Hiragana mogą być używane w systemie spoza Japonii z zainstalowanym japońskim pakietem językowym. Ponadto użycie stałych VbStrConv.Wide i VbStrConv.Narrow jest obsługiwane w dowolnym systemie z zainstalowanym językiem wschodnioazjatyckim.

Ta funkcja używa informacji o kulturze aplikacji w trakcie manipulowania ciągiem tak, aby zmiany sprawy odpowiadały ustawieniom regionalnym, w ramach których aplikacja jest używana.

Ważne

Jeśli aplikacja podejmuje decyzje dotyczące zabezpieczeń na podstawie wyniku operacji porównania lub zmiany wielkości liter, operacja powinna używać String.Compare metody i przekazać Ordinal argument lub OrdinalIgnoreCase .comparisonType Aby uzyskać więcej informacji, zobacz How Culture Affects Strings in Visual Basic (Jak kultura wpływa na ciągi w Visual Basic).

Ustawienia argumentów Conversion to:

Element członkowski wyliczenia Opis
VbStrConv.None Nie wykonuje konwersji
VbStrConv.LinguisticCasing Używa reguł językowych dla wielkości liter, a nie systemu plików (ustawienie domyślne). Prawidłowe z VbStrConv.UpperCase i VbStrConv.LowerCase tylko.
VbStrConv.UpperCase Konwertuje ciąg na wielkie litery.
VbStrConv.LowerCase Konwertuje ciąg na małe litery.
VbStrConv.ProperCase Konwertuje pierwszą literę każdego wyrazu w ciągu na wielkie litery.
VbStrConv.Wide * Konwertuje wąskie (pół szerokości) znaki w ciągu na znaki szerokie (pełnej szerokości). Konwersja może używać formularza normalizacji C, nawet jeśli znak wejściowy jest już pełnowymiarowy. Na przykład ciąg "は ゙" (który jest już pełny) jest znormalizowany do "ば". Zobacz Formularze normalizacji Unicode.
VbStrConv.Narrow * Konwertuje znaki szerokie (pełnej szerokości) w ciągu na znaki wąskie (pół szerokości).
VbStrConv.Katakana ** Konwertuje znaki Hiragana w ciągu na znaki Katakana.
VbStrConv.Hiragana ** Konwertuje znaki Katakana w ciągu na znaki Hiragana.
VbStrConv.SimplifiedChinese * Konwertuje tradycyjne znaki chińskie na chiński uproszczony.
VbStrConv.TraditionalChinese * Konwertuje uproszczone znaki chińskie na chiński tradycyjny.

* Dotyczy ustawień regionalnych azjatyckich.

** Dotyczy tylko Japonii.

Uwaga

Te stałe są określane w środowisku uruchomieniowym języka wspólnego .NET Framework. W związku z tym można ich używać w dowolnym miejscu w kodzie zamiast rzeczywistych wartości. Większość z nich można połączyć (na przykład ), z wyjątkiem sytuacji, UpperCase + Widegdy wzajemnie się wykluczają (na przykład VbStrConv.Wide + VbStrConv.Narrow).

Poniżej znajdują się prawidłowe separatory wyrazów dla odpowiedniej wielkości liter: Null (Chr$(0)), pozioma tabulator (Chr$(9)), kreska liniowa (Chr$(10)), karta pionowa (Chr$(11)), źródło formularza (Chr$(12)), znak powrotu karetki (Chr$(13)), spacja (zestaw znaków jednobajtowych) (Chr$(32)). Rzeczywista wartość przestrzeni, która może być pełna lub pół szerokości, różni się w zależności od kraju/regionu dla kultur Azji Wschodniej.

Dotyczy

Zobacz też