Strings.StrConv(String, VbStrConv, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 -> stringstatic member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> stringPublic Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As StringParameter
- str
- String
Required.
String ekspresi yang akan dikonversi.
- Conversion
- VbStrConv
Required. VbStrConv Anggota. Nilai enumerasi yang menentukan jenis konversi yang akan dilakukan.
- LocaleID
- Int32
Optional. Nilainya LocaleID , jika berbeda dari nilai sistem LocaleID . (Nilai sistem LocaleID adalah default.)
Mengembalikan
String yang dikonversi seperti yang ditentukan.
- Atribut
Pengecualian
Konversi yang tidak didukung LocaleID, Conversion< 0 atau > 2048, 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.NarrowVbStrConv.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.
Important
Jika aplikasi Anda membuat keputusan keamanan berdasarkan hasil dari perbandingan atau perubahan kasus, maka operasi tersebut harus menggunakan metode String.Compare, dan meneruskan Ordinal atau OrdinalIgnoreCase sebagai argumen comparisonType. Untuk informasi selengkapnya, lihat Cara Budaya Memengaruhi String di Visual Basic.
Pengaturan Conversion argumen adalah:
| Anggota enumerasi | Deskripsi |
|---|---|
VbStrConv.None |
Tidak melakukan konversi |
VbStrConv.LinguisticCasing |
Menggunakan aturan linguistik untuk casing, bukan Sistem File (default). Valid dengan VbStrConv.UpperCase dan VbStrConv.LowerCase saja. |
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.
Note
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 gerbong (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.
