String.ToUpperInvariant Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

String.Manipulation.cs

Gibt eine in Großbuchstaben konvertierte Kopie dieses String -Objekts zurück, wobei die Regeln der Groß- und Kleinschreibung der invarianten Kultur verwendet werden.

public:
 System::String ^ ToUpperInvariant();

public string ToUpperInvariant ();

member this.ToUpperInvariant : unit -> string

Public Function ToUpperInvariant () As String

Gibt zurück

String

Die Entsprechung der aktuellen Zeichenfolge in Großbuchstaben.

Beispiele

Im folgenden Beispiel wird ein Zeichenfolgenarray definiert, das ein einzelnes Wort in einer Reihe von Sprachen enthält. Die ToUpperInvariant -Methode wird verwendet, um die Elemente eines parallelen Arrays mit der version ohne Beachtung der Groß-/Kleinschreibung jedes Worts aufzufüllen. Die Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) -Methode wird verwendet, um das Array zu sortieren, das die Groß-/Kleinschreibung berücksichtigt, basierend auf der Reihenfolge der Elemente im Großbuchstabenarray, um sicherzustellen, dass Elemente unabhängig von der Sprache in derselben Reihenfolge angezeigt werden.

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
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

Hinweise

Die invariante Kultur stellt eine Kultur dar, die kulturunabhängig ist. Es ist der englischen Sprache zugeordnet, aber nicht mit einem bestimmten Land oder einer bestimmten Region. Weitere Informationen finden Sie in den Ausführungen zur CultureInfo.InvariantCulture-Eigenschaft.

Wenn Ihre Anwendung davon abhängt, ob sich eine Zeichenfolge auf vorhersagbare Weise ändert, die von der aktuellen Kultur nicht betroffen ist, verwenden Sie die ToUpperInvariant -Methode. Die ToUpperInvariant -Methode entspricht ToUpper(CultureInfo.InvariantCulture). Die -Methode wird empfohlen, wenn eine Auflistung von Zeichenfolgen in einer vorhersagbaren Reihenfolge in einem Benutzeroberflächensteuerelement angezeigt werden muss.

Hinweis

Diese Methode ändert den Wert der aktuellen instance nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Zeichen im aktuellen instance in Großbuchstaben konvertiert werden.

Wenn Sie die Klein- oder Großbuchstabenversion eines Betriebssystembezeichners benötigen, z. B. einen Dateinamen, eine Benannte Pipe oder einen Registrierungsschlüssel, verwenden Sie die ToLowerInvariant -Methode oder ToUpperInvariant .

Weitere Informationen

• ToLowerInvariant()
• ToUpper()
• InvariantCulture