Strings.StrConv(String, VbStrConv, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.Katakana
i 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ż
- Chr(Int32)
- ChrW(Int32)
- String
- ArgumentException
-
manipulowania ciągami - funkcje konwersji typów