Freigeben über


_Application3.FormatString(Object, String, String) Methode

Definition

Formatiert die angegebene Zeichenfolge oder den angegebenen XML-Knoten entsprechend der angegebenen Kategorie und den angegebenen Optionsparametern.

public:
 System::String ^ FormatString(System::Object ^ varInput, System::String ^ bstrCategory, System::String ^ bstrOptions);
public string FormatString (object varInput, string bstrCategory, string bstrOptions);
abstract member FormatString : obj * string * string -> string
Public Function FormatString (varInput As Object, bstrCategory As String, bstrOptions As String) As String

Parameter

varInput
Object

Der Wert oder XML-Knoten, der formatiert werden soll.

bstrCategory
String

Der Wert, der die Kategorie angibt, die für die Formatierung verwendet wird. Die Werte umfassen "number", "percentage", "currency", "date", "time" und "datetime".

bstrOptions
String

Der Wert, der die Optionen angibt, die für die Formatierung verwendet werden. Nimmt die Form einer Zeichenfolge im Format "Optionsname:Wert" an, bei der die Groß- und Kleinschreibung berücksichtigt wird.

Gibt zurück

Ein string-Element, das entsprechend der angegebenen Kategorie und den angegebenen Optionsparametern formatiert wird.

Implementiert

Beispiele

Im folgenden Beispiel wird die FormatString-Methode des Application -Objekts verwendet, um die angegebene Datumszeichenfolge in ein langes Datumsformat zu formatieren:

string myDate = thisApplication.<span class="label">FormatString</span>(
   "2003-01-08", "date", "dateFormat:Long Date");
Dim myDate As String = thisApplication.<span class="label">FormatString</span>( _
   "2003-01-08", "date", "dateFormat:Long Date")

Im folgenden Beispiel wird die FormatString-Methode des Application -Objekts verwendet, um die angegebene Datumszeichenfolge in ein langes Datumsformat zu formatieren:

string myDate = thisApplication.<span class="label">FormatString</span>(
   "2003-01-08", "date", "dateFormat:Long Date");
Dim myDate As String = thisApplication.<span class="label">FormatString</span>( _
   "2003-01-08", "date", "dateFormat:Long Date")

Hinweise

Die FormatString-Methode kann an jeder beliebigen Stelle verwendet werden, an der Sie das Format einer angegebenen Zeichenfolge ändern müssen. Sie muss mit dem Application-Namen gekennzeichnet werden, und ihre Rückgabewerte müssen einer Variablen zugewiesen oder als Ausdruck verwendet werden, für den ein Zeichenfolgenwert erforderlich ist.

In den folgenden Abschnitten sind die Werte aufgeführt, die für bstrCategory und bstrOptionsverwendet werden können:

Liste der Kategorien

number Verwendet numerische Werte. Gültige Optionen für diese Kategorie sind "locale", "numDigits", "leadingZero", "grouping", "decimalSep", "thousandSep" und "negativeOrder".
Prozentsatz Verwendet Prozentwerte. Gültige Optionen für diese Kategorie sind "locale", "numDigits", "leadingZero", "grouping", "decimalSep", "thousandSep" und "negativeOrder".
currency Verwendet Währungswerte. Gültige Optionen für diese Kategorie sind "locale", "numDigits", "leadingZero", "grouping", "decimalSep", "thousandSep" sowie "negativeOrder", "positiveOrder" und "currencyLocale".
date Verwendet Datumswerte. Gültige Optionen für diese Kategorie sind "locale", "dateFormat", "useAltCalendar" und "useEnglishStringsAlways".
time Verwendet Zeitwerte. Gültige Optionen für diese Kategorie sind "locale", "timeFormat" und "noSeconds".
Datetime Verwendet Datum-Zeit-Werte. Gültige Optionen für diese Kategorie sind "locale", "dateFormat", "timeFormat", "noSeconds", "useAltCalendar" und "useEnglishStringAlways".

Liste der Optionen

locale Gibt den Gebietsschemabezeichner (Locale Identifier, LCID) an. Wenn diese Option nicht angegeben wird, entspricht sie standardmäßig der LCID des aktuellen Benutzers.
numDigits Gibt die Anzahl der Dezimalstellen nach dem Dezimaltrennzeichen an. Der Wert auto kann auch verwendet werden, um anzugeben, dass die Anzahl der eingegebenen Dezimalstellen die Anzahl der Dezimalstellen in der Ausgabe ist. Beispiel: 1.234, 1.234, 1.00, 1.00, 1.56e2 oder 156.00. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
leadingZero Gibt an, ob in Dezimalfeldern führende Nullen verwendet werden sollen. "0" gibt an, dass keine führenden Nullen verwendet werden sollen; "1" gibt an, dass führende Nullen verwendet werden sollen. Wenn die Option nicht angegeben wird, wird standardmäßig der entsprechende Wert in den Landes- und Regionaleinstellungen verwendet.
Gruppierung Gibt die Größe jeder Zifferngruppe links vom Dezimaltrennzeichen an. Gültige Werte sind "0" bis "9" und "32". Der Wert "32" zeigt an, dass zuerst drei Ziffern und danach zwei Ziffern eine Gruppe bilden. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
decimalSep Gibt das Dezimaltrennzeichen an. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
thousandSep Gibt das 1000er-Trennzeichen an. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
negativeOrder Gibt das Format für negative Zahlen an. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
positiveOrder Gibt das Format für positive Zahlen an. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem entsprechenden Wert in den Landes- und Regionaleinstellungen.
currencyLocale Gibt den Gebietsschemabezeichner (Locale Identifier - LCID) für das Währungssymbol an. Wenn die Option nicht angegeben wird, entspricht sie standardmäßig dem durch das Gebietsschema angegebenen Wert.
Dateformat Gibt eine Formatbildzeichenfolge an, die zum Bilden der Datumszeichenfolge verwendet wird. Die Werte "Short Date", "Long Date", "Year Month" und "none" können auch verwendet werden, um kurzes Datumsformat, langes Datumsformat, Jahresmonatsformat bzw. kein Format anzugeben. "Short Date", "Long Date" und "Year Month" sind die Standardformate, die von den Regional- und Spracheinstellungen des Betriebssystems bereitgestellt werden.
useAltCalendar Gibt an, ob ein alternativer Kalender für die Datumsformatierung verwendet werden soll. "0" gibt an, dass der normale Kalender verwendet werden soll; "1" gibt an, dass der alternative Kalender verwendet werden soll. Wenn diese Option nicht angegeben wird, entspricht sie standardmäßig dem Wert "0".
useEnglishStringsAlways Gibt an, ob immer englische Zeichenfolgen für die Datumsformatierung verwendet werden sollen. "0" gibt an, dass die durch das Gebietsschema angegebene Sprache verwendet werden soll; "1" gibt an, dass immer englische Zeichenfolgen verwendet werden sollen. Wenn diese Option nicht angegeben wird, entspricht sie standardmäßig dem Wert "0".
Timeformat Gibt eine Formatzeichenfolge an, die verwendet wird, um die Zeitzeichenfolge zu bilden. Außerdem kann der Wert "none" verwendet werden, um kein Format anzugeben. Wenn diese Option nicht angegeben wird, entspricht sie standardmäßig dem in den Landes- und Regionaleinstellungen angegebenen Zeitformat.
noSeconds Gibt an, ob keine Sekunden verwendet werden sollen. Gibt "0" an, wenn Sekunden verwendet werden sollen; gibt "1" an, wenn keine Sekunden verwendet werden sollen. Wenn diese Option nicht angegeben wird, entspricht sie standardmäßig dem Wert "0".

Gilt für: