Bagikan melalui

Strings.StrConv(String, VbStrConv, Int32) Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.VisualBasic
Rakitan:
Microsoft.VisualBasic.Core.dll
Rakitan:
Microsoft.VisualBasic.dll
Sumber:
Strings.vb
Sumber:
Strings.vb
Sumber:
Strings.vb

Mengembalikan string yang dikonversi seperti yang ditentukan.

[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

Diperlukan. String ekspresi yang akan dikonversi.

Conversion
VbStrConv

Diperlukan. VbStrConv anggota. Nilai enumerasi yang menentukan jenis konversi yang akan dilakukan.

LocaleID
Int32

Fakultatif. Nilai LocaleID, jika berbeda dari nilai LocaleID sistem. (Nilai LocaleID sistem adalah default.)

Mengembalikan

String

String yang dikonversi seperti yang ditentukan.

Atribut
SupportedOSPlatformAttribute

Pengecualian

ArgumentException

Konversi LocaleID, Conversion< 0 atau > 2048 yang tidak didukung, atau tidak didukung untuk lokal tertentu.

Contoh

Contoh ini mengonversi teks menjadi semua huruf kecil.

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

Keterangan

Konstanta VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, dan VbStrConv.Hiragana dapat menyebabkan kesalahan run-time ketika digunakan di lokal di mana mereka tidak berlaku, tetapi tidak selalu: konstanta VbStrConv.Katakana dan VbStrConv.Hiragana dapat digunakan dalam sistem non-Jepang dengan Paket Bahasa Jepang diinstal. Selain itu, penggunaan konstanta VbStrConv.Wide dan VbStrConv.Narrow didukung pada sistem apa pun dengan bahasa Asia Timur yang diinstal.

Fungsi ini menggunakan informasi budaya aplikasi saat memanipulasi string sehingga perubahan kasus sesuai untuk lokal tempat aplikasi digunakan.

Penting

Jika aplikasi Anda membuat keputusan keamanan berdasarkan hasil operasi perbandingan atau perubahan kasus, maka operasi harus menggunakan metode String.Compare, dan meneruskan Ordinal atau OrdinalIgnoreCase untuk argumen comparisonType. Untuk informasi selengkapnya, lihat Bagaimana Budaya Memengaruhi String di Visual Basic.

Pengaturan argumen Conversion adalah:

Anggota enumerasi Deskripsi
VbStrConv.None Tidak melakukan konversi
VbStrConv.LinguisticCasing Menggunakan aturan linguistik untuk casing, bukan Sistem File (default). Valid hanya dengan VbStrConv.UpperCase dan VbStrConv.LowerCase.
VbStrConv.UpperCase Mengonversi string menjadi karakter huruf besar.
VbStrConv.LowerCase Mengonversi string menjadi karakter huruf kecil.
VbStrConv.ProperCase Mengonversi huruf pertama setiap kata dalam string menjadi huruf besar.
VbStrConv.Wide * Mengonversi karakter sempit (lebar setengah) dalam string menjadi karakter lebar (lebar penuh). Konversi dapat menggunakan Formulir Normalisasi C meskipun karakter input sudah lebar penuh. Misalnya, string "は ゙" (yang sudah lebar penuh) dinormalisasi menjadi "ば". Lihat formulir normalisasi Unicode .
VbStrConv.Narrow * Mengonversi karakter lebar (lebar penuh) dalam string menjadi karakter sempit (lebar setengah).
VbStrConv.Katakana ** Mengonversi karakter Hiragana dalam string menjadi karakter Katakana.
VbStrConv.Hiragana ** Mengonversi karakter Katakana dalam string menjadi karakter Hiragana.
VbStrConv.SimplifiedChinese * Mengonversi karakter Tionghoa Tradisional menjadi Bahasa Tionghoa Sederhana.
VbStrConv.TraditionalChinese * Mengonversi karakter Tionghoa Sederhana ke Bahasa Tionghoa Tradisional.

* Berlaku untuk lokal Asia.

** Hanya berlaku untuk Jepang.

Nota

Konstanta ini ditentukan dalam runtime bahasa umum .NET Framework. Akibatnya, mereka dapat digunakan di mana saja dalam kode Anda sebagai pengganti nilai aktual. Sebagian besar dapat digabungkan (misalnya, UpperCase + Wide), kecuali ketika keduanya saling eksklusif (misalnya, VbStrConv.Wide + VbStrConv.Narrow).

Berikut ini adalah pemisah kata yang valid untuk casing yang tepat: Null (Chr$(0)), tab horizontal (Chr$(9)), umpan baris (Chr$(10)), tab vertikal (Chr$(11)), umpan formulir (Chr$(12)), pengembalian pengangkutan (Chr$(13)), spasi (set karakter byte tunggal) (Chr$(32)). Nilai aktual untuk ruang, yang bisa lebar penuh atau setengah, bervariasi menurut negara/wilayah untuk budaya Asia Timur.

Berlaku untuk

Lihat juga