_Application3.FormatString(Object, String, String) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

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

Implementiert

FormatString(Object, String, String)

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:

Freigeben über