String.ToUpperInvariant Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

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 jedes Worts ohne Beachtung der Groß-/Kleinschreibung aufzufüllen. Die Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) -Methode wird verwendet, um das Array, bei dem die Groß-/Kleinschreibung beachtet wird, basierend auf der Reihenfolge der Elemente im Großbuchstabenarray zu sortieren, 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
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

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. Sie ist der englischen Sprache zugeordnet, aber nicht einem bestimmten Land oder einer bestimmten Region. Weitere Informationen finden Sie in den Ausführungen zur CultureInfo.InvariantCulture-Eigenschaft.

Wenn Ihre Anwendung davon abhängig ist, dass eine Zeichenfolge auf vorhersagbare Weise geändert wird, 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 Instanz nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Zeichen in der aktuellen Instanz in Großbuchstaben konvertiert werden.

Sicherheitsüberlegungen

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

Gilt für:

Siehe auch