ApplicationBase.ChangeCulture(String) Methode

Definition

Ändert die Kultur, die vom aktuellen Thread für die Bearbeitung und Formatierung von Zeichenfolgen verwendet wird.Changes the culture used by the current thread for string manipulation and for string formatting.

public:
 void ChangeCulture(System::String ^ cultureName);
public void ChangeCulture (string cultureName);
member this.ChangeCulture : string -> unit
Public Sub ChangeCulture (cultureName As String)

Parameter

cultureName
String

String.String. Der Name der Kultur als Zeichenfolge.Name of the culture as a string. Eine Liste der möglichen Namen finden Sie unter CultureInfo.For a list of possible names, see CultureInfo.

Ausnahmen

cultureName ist Nothing.cultureName is Nothing.

cultureName ist kein gültiger Kulturname.cultureName is not a valid culture name.

Beispiele

In diesem Beispiel wird veranschaulicht, wie die Änderung der Kultur die Zeichen folgen Darstellung von Datumsangaben ändert.This example demonstrates how changing the culture changes the string representation of dates.

Private Sub TestChangeCulture()
    ' Store the current culture.
    Dim currentculture As String = My.Application.Culture.Name
    MsgBox("Current culture is " & currentculture)

    Dim jan1 As New Date(2005, 1, 1, 15, 15, 15)

    My.Application.ChangeCulture("en-US")
    MsgBox("Date represented in en-US culture: " & jan1)
    ' 1/1/2005 3:15:15 PM

    My.Application.ChangeCulture("")
    MsgBox("Date represented in invariant culture" & jan1)
    ' 01/01/2005 15:15:15

    ' Restore the culture.
    My.Application.ChangeCulture(currentculture)
End Sub

Hinweise

Die My.Application.ChangeCulture -Methode ändert die-Eigenschaft des aktuellen Threads CurrentCulture .The My.Application.ChangeCulture method changes the current thread's CurrentCulture property. CurrentCulture bestimmt die Standardformate für Datumsangaben, Uhrzeiten, Währungen, Ziffern, Sortierreihenfolge von Text, Zeichen folgen Vergleiche und die Groß-/Kleinschreibung für alle Berechnungen in diesem Thread.CurrentCulture determines the default formats for dates, times, currency, numbers, sorting order of text, string comparisons, and casing for all computations on that thread.

Zum Abrufen der aktuellen Kultur können Sie die- Culture Eigenschaft oder die- CurrentCulture Eigenschaft verwenden.To retrieve the current culture, you can use the Culture property or the CurrentCulture property.

Diese CurrentCulture Einstellung unterscheidet sich von einer Spracheinstellung.The CurrentCulture setting is different from a language setting. Sie enthält nur Daten, die sich auf die Standardeinstellungen für eine geografische Region beziehen.It contains only data related to the standard settings for a geographical region. Daher kann die- CurrentCulture Eigenschaft nur auf eine bestimmte Kultur oder auf festgelegt werden InvariantCulture .Therefore, the CurrentCulture property can only be set to a specific culture or to the InvariantCulture.

Verwenden Sie die- My.Application.ChangeUICulture Methode, um die Kultur zu ändern, die der aktuelle Thread zum Abrufen von kulturspezifischen Ressourcen verwendet.Use the My.Application.ChangeUICulture method to change the culture that the current thread uses for retrieving culture-specific resources.

Wichtig

Die My.Application.ChangeCulture Methode erfordert eine SecurityPermission mit dem ControlThread Satz.The My.Application.ChangeCulture method requires a SecurityPermission with the ControlThread set. Das Manipulieren von Threads ist aufgrund des mit Threads verbundenen Sicherheitszustands gefährlich.Manipulating threads is dangerous because of the security state associated with threads. Daher sollte diese Berechtigung nur bei Bedarf für vertrauenswürdigen Code erteilt werden.Therefore, this permission should be given only as necessary to trustworthy code. In semivertrauens würdigem Code können Sie die Kultur eines Threads nicht ändern.You cannot change a thread's culture in semi-trusted code.

Verfügbarkeit nach ProjekttypAvailability by Project Type

ProjekttypProject type VerfügbarAvailable
Windows Forms-AnwendungWindows Forms Application JaYes
KlassenbibliothekClass Library JaYes
KonsolenanwendungConsole Application JaYes
Windows Forms-SteuerelementbibliothekWindows Forms Control Library JaYes
WebsteuerelementbibliothekWeb Control Library NeinNo
Windows-DienstWindows Service JaYes
WebsiteWeb Site NeinNo

Gilt für:

Weitere Informationen