_Application3.FormatString 方法 (Object, String, String)
根据指定的类别和选项参数，设置指定字符串或 XML 节点的格式。
命名空间： Microsoft.Office.Interop.InfoPath.SemiTrust
程序集： Microsoft.Office.Interop.InfoPath.SemiTrust（位于 Microsoft.Office.Interop.InfoPath.SemiTrust.dll 中）
语法
声明
Function FormatString ( _
varInput As Object, _
bstrCategory As String, _
bstrOptions As String _
) As String
用法
Dim instance As _Application3
Dim varInput As Object
Dim bstrCategory As String
Dim bstrOptions As String
Dim returnValue As String
returnValue = instance.FormatString(varInput, _
bstrCategory, bstrOptions)
string FormatString(
Object varInput,
string bstrCategory,
string bstrOptions
)
参数
varInput
类型：System.Object要设置格式的值或 XML 节点。
bstrCategory
类型：System.String该值指定用于设置格式的类别。值包括数字、百分比、货币、日期、时间和日期时间。
bstrOptions
类型：System.String该值指定用于设置格式的选项。采取字符串的形式，并区分大小写，其格式为"optionName:value"。
返回值
类型：System.String
根据指定的类别和选项参数设置格式的 string。
实现
_Application2.FormatString(Object, String, String)
_Application.FormatString(Object, String, String)
备注
FormatString 方法可用在您需要更改指定字符串格式的任何位置。它必须由应用程序名称限定，其返回值必须分配给变量或用于需要字符串值的表达式。
以下部分列出可用于 bstrCategory 和 bstrOptions 的值：
类别列表
名称 |
说明 |
|---|---|
number |
使用数值。此类别的有效选项包括"locale"、"numDigits"、"leadingZero"、"grouping"、"decimalSep"、"thousandSep"和"negativeOrder"。 |
percentage |
使用百分比值。此类别的有效选项包括"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 则使用前导零。如果没有指定，则默认为区域设置中的相应值。 |
grouping |
指定小数点左边每组数字的位数。有效值为 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。 |
示例
在以下示例中，将使用 Application 对象的 FormatString 方法将指定的日期字符串设置为长日期格式：
string myDate = thisApplication.FormatString(
"2003-01-08", "date", "dateFormat:Long Date");
Dim myDate As String = thisApplication.FormatString( _
"2003-01-08", "date", "dateFormat:Long Date")