String.ToUpperInvariant Methode

Definitie

Naamruimte:

System

Assembly:

mscorlib.dll

Hiermee wordt een kopie van dit String object geretourneerd die wordt geconverteerd naar hoofdletters met behulp van de hoofdletterregels van de invariante cultuur.

public:
 System::String ^ ToUpperInvariant();

public string ToUpperInvariant();

member this.ToUpperInvariant : unit -> string

Public Function ToUpperInvariant () As String

Retouren

String

Het hoofdlettere equivalent van de huidige tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt een tekenreeksmatrix gedefinieerd die één woord in een aantal talen bevat. De ToUpperInvariant methode wordt gebruikt om de elementen van een parallelle matrix te vullen met de hoofdlettergevoelige versie van elk woord. De Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) methode wordt gebruikt om de hoofdlettergevoelige matrix te sorteren op basis van de volgorde van elementen in de matrix met hoofdletters om ervoor te zorgen dat elementen in dezelfde volgorde worden weergegeven, ongeacht de taal.

using System;
using System.IO;

public class Example
{
   public static void Main()
   {
      string[] words = { "Tuesday", "Salı", "Вторник", "Mardi", 
                         "Τρίτη", "Martes", "יום שלישי", 
                         "الثلاثاء", "วันอังคาร" };
      StreamWriter sw = new StreamWriter(@".\output.txt");
            
      // Display array in unsorted order.
      foreach (string word in words)
         sw.WriteLine(word);

      sw.WriteLine();

      // Create parallel array of words by calling ToUpperInvariant.
      string[] upperWords = new string[words.Length];
      for (int ctr = words.GetLowerBound(0); ctr <= words.GetUpperBound(0); ctr++)
         upperWords[ctr] = words[ctr].ToUpperInvariant();
      
      // Sort the words array based on the order of upperWords.
      Array.Sort(upperWords, words, StringComparer.InvariantCulture);
      
      // Display the sorted array.
      foreach (string word in words)
         sw.WriteLine(word);

      sw.Close();      
   }
}
// The example produces the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

open System
open System.IO

do
    let words = 
        [| "Tuesday"; "Salı"; "Вторник"; "Mardi" 
           "Τρίτη"; "Martes"; "יום שלישי" 
           "الثلاثاء"; "วันอังคาร" |]
    use sw = new StreamWriter(@".\output.txt")
        
    // Display array in unsorted order.
    for word in words do
        sw.WriteLine word

    sw.WriteLine()

    // Create parallel array of words by calling ToUpperInvariant.
    let upperWords = words |> Array.map (fun x -> x.ToUpperInvariant())
    
    // Sort the words array based on the order of upperWords.
    Array.Sort(upperWords, words, StringComparer.InvariantCulture)
    
    // Display the sorted array.
    for word in words do
        sw.WriteLine word
    sw.Close()      
// The example produces the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

Imports System.IO

Module Example
   Public Sub Main()
      Dim words() As String = { "Tuesday", "Salı", "Вторник", "Mardi", _
                                "Τρίτη", "Martes", "יום שלישי", _
                                "الثلاثاء", "วันอังคาร" }
      Dim sw As New StreamWriter(".\output.txt")
      
      ' Display array in unsorted order.
      For Each word As String In words
         sw.WriteLine(word)
      Next
      sw.WriteLine()

      ' Create parallel array of words by calling ToUpperInvariant.
      Dim upperWords(words.Length - 1) As String
      For ctr As Integer = words.GetLowerBound(0) To words.GetUpperBound(0)
         upperWords(ctr) = words(ctr).ToUpperInvariant()
      Next
      
      ' Sort the words array based on the order of upperWords.
      Array.Sort(upperWords, words, StringComparer.InvariantCulture)
      
      ' Display the sorted array.
      For Each word As String In words
         sw.WriteLine(word)
      Next
      
      sw.Close()
   End Sub
End Module
' The example produces the following output:
'       Tuesday
'       Salı
'       Вторник
'       Mardi
'       Τρίτη
'       Martes
'       יום שלישי
'       الثلاثاء
'       วันอังคาร
'       
'       Mardi
'       Martes
'       Salı
'       Tuesday
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

Opmerkingen

De invariante cultuur vertegenwoordigt een cultuur die niet gevoelig is voor cultuur. Het is gekoppeld aan de Engelse taal, maar niet met een specifiek land of specifieke regio. Voor meer informatie, zie de eigenschap CultureInfo.InvariantCulture.

Als uw toepassing afhankelijk is van het geval dat een tekenreeks wordt gewijzigd op een voorspelbare manier die niet wordt beïnvloed door de huidige cultuur, gebruikt u de ToUpperInvariant methode. De ToUpperInvariant methode is gelijk aan ToUpper(CultureInfo.InvariantCulture). De methode wordt aanbevolen wanneer een verzameling tekenreeksen moet worden weergegeven in een voorspelbare volgorde in een besturingselement voor de gebruikersinterface.

Note

Met deze methode wordt de waarde van het huidige exemplaar niet gewijzigd. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd waarin alle tekens in het huidige exemplaar worden geconverteerd naar hoofdletters.

Als u de kleine letters of hoofdletters van een besturingssysteem-id nodig hebt, zoals een bestandsnaam, benoemde pipe of registersleutel, gebruikt u de ToLowerInvariant of ToUpperInvariant methoden.

Zie ook

• ToLowerInvariant()
• ToUpper()
• InvariantCulture