Udostępnij za pośrednictwem


Strings.StrConv(String, VbStrConv, Int32) Metoda

Definicja

Zwraca ciąg przekonwertowany zgodnie z określonymi.

[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 do przekonwertowania.

Conversion
VbStrConv

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

LocaleID
Int32

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

Zwraca

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

Atrybuty

Wyjątki

Nieobsługiwane LocaleID, Conversion< 0 lub > 2048 lub nieobsługiwana konwersja 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.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakanai 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 innych niż japoński z zainstalowanym pakietem językowym japońskim. 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 podczas manipulowania ciągiem, tak aby zmiany wielkości liter były odpowiednie dla ustawień regionalnych, w których aplikacja jest używana.

Ważny

Jeśli aplikacja podejmuje decyzje dotyczące zabezpieczeń na podstawie wyniku operacji porównania lub zmiany wielkości liter, operacja powinna używać metody String.Compare i przekazać Ordinal lub OrdinalIgnoreCase dla argumentu comparisonType. Aby uzyskać więcej informacji, zobacz How Culture Wpływa na ciągi w języku 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łowy tylko z VbStrConv.UpperCase i VbStrConv.LowerCase.
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 o szerokości (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łnowymiarowy) jest znormalizowany do ciągu "ば". Zobacz formularze normalizacji Unicode.
VbStrConv.Narrow * Konwertuje szerokie (pełnej szerokości) znaki w ciągu na wąskie (pół szerokości) znaków.
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.

Nuta

Te stałe są określane w środowisku uruchomieniowym języka wspólnego programu .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 UpperCase + Wide), z wyjątkiem sytuacji, gdy wzajemnie się wykluczają (na przykład VbStrConv.Wide + VbStrConv.Narrow).

Poniżej przedstawiono prawidłowe separatory wyrazów dla odpowiedniej wielkości liter: Null (Chr$(0)), karta pozioma (Chr$(9)), kanał informacyjny wiersza (Chr$(10)), pionowa karta (Chr$(11)), źródło formularza (Chr$(12)), powrót 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ż