_Application3.FormatString(Object, String, String) 方法

定义

命名空间:

Microsoft.Office.Interop.InfoPath

程序集:

Microsoft.Office.Interop.InfoPath.dll

根据指定的类别和选项参数，设置指定字符串或 XML 节点的格式。

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

参数

varInput

Object

要设置格式的值或 XML 节点。

bstrCategory

String

该值指定用于设置格式的类别。 值包括数字、百分比、货币、日期、时间和日期时间。

bstrOptions

String

该值指定用于设置格式的选项。 采取字符串的形式，并区分大小写，其格式为“optionName:value”。

返回

String

根据指定的类别和选项参数设置格式的指定字符串或 XML 节点。

实现

FormatString(Object, String, String)

示例

在以下示例中，对象的 FormatString 方法 Application 用于将指定的日期字符串的格式设置为长日期格式：

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

注解

FormatString 方法可用在您需要更改指定字符串格式的任何位置。 它必须由应用程序名称限定，其返回值必须分配给变量或用于需要字符串值的表达式。

下表列出了可用于 bstrCategory 和 bstrOptions的值：

类别列表

number	使用数值。 此类别的有效选项包括“locale”、“numDigits”、“leadingZero”、“grouping”、“decimalSep”、“thousandSep”和“negativeOrder”。
百分比	使用百分比值。 此类别的有效选项包括“locale”、“numDigits”、“leadingZero”、“grouping”、“decimalSep”、“thousandSep”和“negativeOrder”。
currency	使用货币值。 此类别的有效选项包括“locale”、“numDigits”、“leadingZero”、“grouping”、“decimalSep”、“thousandSep”和“negativeOrder”、“positiveOrder”和“currencyLocale”。
date	使用数值。 此类别的有效选项包括“locale”、“dateFormat”、“useAltCalendar”和“useEnglishStringsAlways”。
time	使用时间值。 此类别的有效选项包括“locale”、“timeFormat”和“noSeconds”。
Datetime	使用日期时间值。 此类别的有效选项包括“locale”、“dateFormat”、“timeFormat”、“noSeconds”、“useAltCalendar”和“useEnglishStringAlways”。

选项列表

locale	指定区域设置标识符 (LCID)。 如果没有指定，则默认为当前用户的 LCID。
numDigits	指定小数分隔符后的小数位数。 值为 auto 可能用于表示输入的小数位数就是输出的小数位数。 例如，1.234、1.234、1.00、1.00、1.56e2 或 156.00。 如果没有指定，则默认为区域设置中的相应值。
leadingZero	指定是否在小数域中使用前导零。 指定为 0 则不使用前导零，指定为 1 则使用前导零。 如果没有指定，则默认为区域设置中的相应值。
分组	指定小数点左边每组数字的位数。 有效值为 0–9 和 32。 值为 32 表示首先三位一组，然后两位一组。 如果没有指定，则默认为区域设置中的相应值。
decimalSep	指定小数分隔符字符串。 如果没有指定，则默认为区域设置中的相应值。
thousandSep	指定千位分隔符字符串。 如果没有指定，则默认为区域设置中的相应值。
negativeOrder	指定负数模式。 如果没有指定，则默认为区域设置中的相应值。
positiveOrder	指定正数模式。 如果没有指定，则默认为区域设置中的相应值。
currencyLocale	指定货币符号的区域设置标识符 (LCID)。 如果没有指定，则默认为区域设置指定的值。
dateFormat	指定用于设置日期字符串格式的格式图片字符串。 值“Short Date”、“Long Date”、“Year Month”和“none”也可分别用来表示短日期格式、长日期格式、年月格式和无格式。 “Short Date”、“Long Date”和“Year Month”是操作系统区域和语言设置中的默认格式。
useAltCalendar	指定是否为日期格式使用备用日历。 指定为 0 则使用常规日历，指定为 1 则使用备用日历。 如果没有指定，则默认为 0。
useEnglishStringsAlways	指定是否总是为日期格式使用英语字符串。 指定为 0 则使用区域设置指定的语言，指定为 1 则总使用英语。 如果没有指定，则默认为 0。
timeFormat	指定用于设置时间字符串格式的格式字符串。 值“none”也可用于表示无格式。 如果没有指定，则默认使用区域设置中的时间格式。
noSeconds	指定是否使用秒。 指定为 0 则使用秒，指定为 1 则不使用秒。 如果没有指定，则默认为 0。