Bagikan melalui


Strings.StrConv(String, VbStrConv, Int32) Metode

Definisi

Mengembalikan string yang dikonversi sesuai ketentuan.

[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

Wajib diisi. String ekspresi yang akan dikonversi.

Conversion
VbStrConv

Wajib diisi. VbStrConv Anggota. Nilai enumerasi yang menentukan jenis konversi yang akan dilakukan.

LocaleID
Int32

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

Mengembalikan

String yang dikonversi seperti yang ditentukan.

Atribut

Pengecualian

Tidak didukung LocaleID, Conversion< 0 atau > 2048, atau konversi yang 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 perbandingan atau operasi perubahan huruf besar-kecil, maka operasi tersebut 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 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 dari 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.

Catatan

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 mereka 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 (kumpulan 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