Bagikan melalui

Ubah kasus di .NET

Jika Anda menulis aplikasi yang menerima input dari pengguna, Anda tidak akan pernah yakin kasus apa (atas atau bawah) yang akan mereka gunakan untuk memasukkan data. Seringkali, Anda ingin string diformat secara konsisten, terutama jika Anda menampilkannya di antarmuka pengguna. Tabel berikut ini menjelaskan tiga metode perubahan huruf besar/kecil. Dua metode pertama memberikan kelebihan beban yang menerima budaya.

Nama metode Gunakan
String.ToUpper Mengonversi semua karakter dalam string menjadi huruf besar.
String.ToLower Mengonversi semua karakter dalam string menjadi huruf kecil.
TextInfo.ToTitleCase Mengonversi string menjadi huruf kapital di awal kata.

Peringatan

Metode String.ToUpper dan String.ToLower tidak boleh digunakan untuk mengonversi string untuk membandingkannya atau mengujinya untuk kesetaraan. Untuk informasi selengkapnya, lihat bagian Membandingkan string kasus campuran.

Membandingkan string kasus campuran

Untuk membandingkan string kasus campuran untuk menentukan pengurutannya, panggil salah satu kelebihan beban String.CompareTo metode dengan comparisonType parameter, dan berikan nilai , StringComparison.CurrentCultureIgnoreCaseStringComparison.InvariantCultureIgnoreCase, atau StringComparison.OrdinalIgnoreCase untuk comparisonType argumen . Untuk perbandingan menggunakan budaya tertentu selain budaya saat ini, panggil varian metode String.CompareTo dengan parameter culture dan options, dan berikan nilai CompareOptions.IgnoreCase sebagai argumen options.

Untuk membandingkan string huruf besar-kecil campuran untuk menentukan apakah mereka sama, panggil salah satu overload metode String.Equals dengan parameter comparisonType, dan berikan nilai StringComparison.CurrentCultureIgnoreCase, StringComparison.InvariantCultureIgnoreCase, atau StringComparison.OrdinalIgnoreCase untuk argumen comparisonType.

Untuk informasi selengkapnya, lihat Praktik terbaik untuk menggunakan string.

metode ToUpper

Metode String.ToUpper mengubah semua karakter dalam string ke huruf besar. Contoh berikut mengonversi string "Hello World!" dari kasus campuran menjadi huruf besar.

string properString = "Hello World!";
Console.WriteLine(properString.ToUpper());
// This example displays the following output:
//       HELLO WORLD!

Dim MyString As String = "Hello World!"
Console.WriteLine(MyString.ToUpper())
' This example displays the following output:
'       HELLO WORLD!

Contoh sebelumnya secara default sensitif terhadap budaya; menerapkan aturan penulisan huruf berdasarkan budaya saat ini. Untuk melakukan perubahan huruf yang tidak memedulikan budaya atau menerapkan konvensi penulisan huruf dari budaya tertentu, gunakan kelebihan beban metode String.ToUpper(CultureInfo) dan berikan nilai CultureInfo.InvariantCulture atau sebuah objek System.Globalization.CultureInfo yang mewakili budaya yang ditentukan pada parameter culture. Untuk contoh yang menunjukkan cara menggunakan ToUpper metode untuk melakukan perubahan kasus yang tidak peka terhadap budaya, lihat Melakukan perubahan kasus yang tidak peka terhadap budaya.

metode ToLower

Metode String.ToLower ini mirip dengan metode sebelumnya, tetapi sebaliknya mengonversi semua karakter dalam string menjadi huruf kecil. Contoh berikut mengonversi string "Hello World!" menjadi huruf kecil.

string properString = "Hello World!";
Console.WriteLine(properString.ToLower());
// This example displays the following output:
//       hello world!

Dim MyString As String = "Hello World!"
Console.WriteLine(MyString.ToLower())
' This example displays the following output:
'       hello world!

Contoh sebelumnya sensitif terhadap budaya secara default; menerapkan aturan penulisan huruf besar-kecil dari budaya saat ini. Untuk melakukan perubahan kasus yang tidak sensitif terhadap budaya atau menerapkan konvensi penulisan sesuai budaya tertentu, gunakan overload metode String.ToLower(CultureInfo) dan berikan nilai pada CultureInfo.InvariantCulture atau objek System.Globalization.CultureInfo yang mewakili budaya yang telah ditentukan kepada parameter culture. Untuk contoh yang menunjukkan cara menggunakan ToLower(CultureInfo) metode untuk melakukan perubahan kasus yang tidak peka terhadap budaya, lihat Melakukan perubahan kasus yang tidak peka terhadap budaya.

metode ToTitleCase

Mengonversi TextInfo.ToTitleCase karakter pertama dari setiap kata menjadi huruf besar dan karakter yang tersisa menjadi huruf kecil. Namun, kata-kata yang sepenuhnya huruf besar diasumsikan sebagai akronim dan tidak dikonversi.

Metode TextInfo.ToTitleCase ini sensitif terhadap budaya; yaitu menggunakan konvensi casing dari budaya tertentu. Untuk memanggil metode , Anda terlebih dahulu mengambil TextInfo objek yang mewakili konvensi kasing budaya tertentu dari CultureInfo.TextInfo properti budaya tertentu.

Contoh berikut meneruskan setiap string dalam array ke TextInfo.ToTitleCase metode . String mencakup string judul yang tepat serta akronim. String dikonversi ke huruf judul dengan menggunakan konvensi casing budaya Inggris (Amerika Serikat).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { "a tale of two cities", "gROWL to the rescue",
                          "inside the US government", "sports and MLB baseball",
                          "The Return of Sherlock Holmes", "UNICEF and children"};

      TextInfo ti = CultureInfo.CurrentCulture.TextInfo;
      foreach (var value in values)
         Console.WriteLine($"{value} --> {ti.ToTitleCase(value)}");
   }
}
// The example displays the following output:
//    a tale of two cities --> A Tale Of Two Cities
//    gROWL to the rescue --> Growl To The Rescue
//    inside the US government --> Inside The US Government
//    sports and MLB baseball --> Sports And MLB Baseball
//    The Return of Sherlock Holmes --> The Return Of Sherlock Holmes
//    UNICEF and children --> UNICEF And Children

Imports System.Globalization

Module Example
    Public Sub Main()
        Dim values() As String = {"a tale of two cities", "gROWL to the rescue",
                                   "inside the US government", "sports and MLB baseball",
                                   "The Return of Sherlock Holmes", "UNICEF and children"}

        Dim ti As TextInfo = CultureInfo.CurrentCulture.TextInfo
        For Each value In values
            Console.WriteLine("{0} --> {1}", value, ti.ToTitleCase(value))
        Next
    End Sub
End Module
' The example displays the following output:
'    a tale of two cities --> A Tale Of Two Cities
'    gROWL to the rescue --> Growl To The Rescue
'    inside the US government --> Inside The US Government
'    sports and MLB baseball --> Sports And MLB Baseball
'    The Return of Sherlock Holmes --> The Return Of Sherlock Holmes
'    UNICEF and children --> UNICEF And Children

Perhatikan bahwa meskipun sensitif terhadap budaya, metode TextInfo.ToTitleCase ini tidak menyediakan aturan casing yang benar secara linguistik. Misalnya, dalam contoh sebelumnya, metode mengonversi "kisah dua kota" menjadi "A Tale Of Two Cities". Namun, judul casing yang benar secara linguistik untuk budaya en-US adalah "A Tale of Two Cities."

Lihat juga