#region 程序集 Microsoft.VisualBasic, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.6\Microsoft.VisualBasic.dll
#endregion
using Microsoft.VisualBasic.CompilerServices;
using System;
using System.Security;
namespace Microsoft.VisualBasic
{
//
// 摘要:
// Strings 模块包含用于执行字符串操作的过程。
[StandardModule]
public sealed class Strings
{
//
// 摘要:
// 返回表示与某个字符相对应的字符代码的整数值。
//
// 参数:
// String:
// 必需。 任何有效的 Char 或 String 表达式。 如果 String 是一个 String 表达式,则只将字符串的第一个字符用于输入。 如果 String
// 是 Nothing 或不包含任何字符,将会出现 System.ArgumentException 错误。
//
// 返回结果:
// 与某个字符相对应的字符代码。
public static int Asc(char String);
//
// 摘要:
// 返回表示与某个字符相对应的字符代码的整数值。
//
// 参数:
// String:
// 必需。 任何有效的 Char 或 String 表达式。 如果 String 是一个 String 表达式,则只将字符串的第一个字符用于输入。 如果 String
// 是 Nothing 或不包含任何字符,将会出现 System.ArgumentException 错误。
//
// 返回结果:
// 与某个字符相对应的字符代码。
public static int Asc(string String);
//
// 摘要:
// 返回表示与某个字符相对应的字符代码的整数值。
//
// 参数:
// String:
// 必需。 任何有效的 Char 或 String 表达式。 如果 String 是一个 String 表达式,则只将字符串的第一个字符用于输入。 如果 String
// 是 Nothing 或不包含任何字符,将会出现 System.ArgumentException 错误。
//
// 返回结果:
// 与某个字符相对应的字符代码。
public static int AscW(string String);
//
// 摘要:
// 返回表示与某个字符相对应的字符代码的整数值。
//
// 参数:
// String:
// 必需。 任何有效的 Char 或 String 表达式。 如果 String 是一个 String 表达式,则只将字符串的第一个字符用于输入。 如果 String
// 是 Nothing 或不包含任何字符,将会出现 System.ArgumentException 错误。
//
// 返回结果:
// 与某个字符相对应的字符代码。
public static int AscW(char String);
//
// 摘要:
// 返回与指定字符代码相关联的字符。
//
// 参数:
// CharCode:
// 必需。 Integer 表达式,表示字符的 code point 或字符代码。
//
// 返回结果:
// 与指定字符代码相关联的字符。
//
// 异常:
// T:System.ArgumentException:
// Chr 的 CharCode < 0 或 > 255。
public static char Chr(int CharCode);
//
// 摘要:
// 返回与指定字符代码相关联的字符。
//
// 参数:
// CharCode:
// 必需。 Integer 表达式,表示字符的 code point 或字符代码。
//
// 返回结果:
// 与指定字符代码相关联的字符。
//
// 异常:
// T:System.ArgumentException:
// ChrW 的 CharCode < -32768 或 > 65535。
public static char ChrW(int CharCode);
//
// 摘要:
// 返回一个从零开始的数组,该数组包含基于指定筛选条件的 String 数组的子集。
//
// 参数:
// Source:
// 必需。 要搜索的一维字符串数组。
//
// Match:
// 必需。 要搜索的字符串。
//
// Include:
// 可选。 Boolean 值,指示是返回包含还是排除 Match 的子字符串。 如果 Include 为 True,则 Filter 函数返回将 Match
// 作为子字符串包含在其中的数组的子集。 如果 Include 为 False,则 Filter 函数返回不将 Match 作为子字符串包含在其中的数组的子集。
//
// Compare:
// 可选。 表示要使用的字符串比较类型的数值。 请参阅“设置”,以获取值。
//
// 返回结果:
// 一个从零开始的数组,该数组包含基于指定筛选条件的 String 数组的子集。
//
// 异常:
// T:System.ArgumentException:
// Source 为 Nothing 或不是一维数组。
public static string[] Filter(object[] Source, string Match, bool Include = true, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回一个从零开始的数组,该数组包含基于指定筛选条件的 String 数组的子集。
//
// 参数:
// Source:
// 必需。 要搜索的一维字符串数组。
//
// Match:
// 必需。 要搜索的字符串。
//
// Include:
// 可选。 Boolean 值,指示是返回包含还是排除 Match 的子字符串。 如果 Include 为 True,则 Filter 函数返回将 Match
// 作为子字符串包含在其中的数组的子集。 如果 Include 为 False,则 Filter 函数返回不将 Match 作为子字符串包含在其中的数组的子集。
//
// Compare:
// 可选。 表示要使用的字符串比较类型的数值。 请参阅“设置”,以获取值。
//
// 返回结果:
// 一个从零开始的数组,该数组包含基于指定筛选条件的 String 数组的子集。
//
// 异常:
// T:System.ArgumentException:
// Source 为 Nothing 或不是一维数组。
public static string[] Filter(string[] Source, string Match, bool Include = true, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回根据格式 String 表达式中包含的指令设置格式的字符串。
//
// 参数:
// Expression:
// 必需。 任何有效表达式。
//
// Style:
// 可选。 一个有效的命名或用户定义的格式 String 表达式。
//
// 返回结果:
// 根据格式 String 表达式中包含的指令设置格式的字符串。
public static string Format(object Expression, string Style = "");
//
// 摘要:
// 返回一个格式为货币值的表达式,该货币值使用系统控制面板中定义的货币符号。
//
// 参数:
// Expression:
// 必需。 要格式化的表达式。
//
// NumDigitsAfterDecimal:
// 可选。 数值,指示在小数点右侧显示的位数。 默认值为 -1,指示使用了计算机的区域设置。
//
// IncludeLeadingDigit:
// 可选。 Microsoft.VisualBasic.TriState 枚举,指示对于小数值是否显示前导零。 请参见值的“备注”。
//
// UseParensForNegativeNumbers:
// 可选。 Microsoft.VisualBasic.TriState 枚举,指示是否用括号将负值括起来。 请参见值的“备注”。
//
// GroupDigits:
// 可选。 Microsoft.VisualBasic.TriState 枚举,指示是否用计算机区域设置中指定的组分隔符对数字进行分组。 请参见值的“备注”。
//
// 返回结果:
// 一个格式为货币值的表达式,该货币值使用系统控制面板中定义的货币符号。
//
// 异常:
// T:System.ArgumentException:
// 小数点后的数字位数大于 99。
//
// T:System.InvalidCastException:
// 不是数字类型。
public static string FormatCurrency(object Expression, int NumDigitsAfterDecimal = -1, TriState IncludeLeadingDigit = TriState.UseDefault, TriState UseParensForNegativeNumbers = TriState.UseDefault, TriState GroupDigits = TriState.UseDefault);
//
// 摘要:
// 返回一个表示日期/时间值的字符串表达式。
//
// 参数:
// Expression:
// 必需。 要格式化的 Date 表达式。
//
// NamedFormat:
// 可选。 指示所使用的日期/时间格式的数值。 如果省略,则使用 DateFormat.GeneralDate。
//
// 返回结果:
// 一个表示日期/时间值的字符串表达式。
//
// 异常:
// T:System.ArgumentException:
// NamedFormat 设置无效。
public static string FormatDateTime(DateTime Expression, DateFormat NamedFormat = DateFormat.GeneralDate);
//
// 摘要:
// 返回格式化为数字的表达式。
//
// 参数:
// Expression:
// 必需。 要格式化的表达式。
//
// NumDigitsAfterDecimal:
// 可选。 数值,指示在小数点右侧显示的位数。 默认值为 -1,指示使用了计算机的区域设置。
//
// IncludeLeadingDigit:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示对于小数值是否显示前导零。 请参阅“设置”,以获取值。
//
// UseParensForNegativeNumbers:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示是否用括号将负值括起来。 请参阅“设置”,以获取值。
//
// GroupDigits:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示是否使用区域设置中指定的组分隔符对数字进行分组。 请参阅“设置”,以获取值。
//
// 返回结果:
// 格式化为数字的表达式。
//
// 异常:
// T:System.InvalidCastException:
// 不是数字类型。
public static string FormatNumber(object Expression, int NumDigitsAfterDecimal = -1, TriState IncludeLeadingDigit = TriState.UseDefault, TriState UseParensForNegativeNumbers = TriState.UseDefault, TriState GroupDigits = TriState.UseDefault);
//
// 摘要:
// 返回以 % 字符结尾的百分比格式的表达式(即乘以 100)。
//
// 参数:
// Expression:
// 必需。 要格式化的表达式。
//
// NumDigitsAfterDecimal:
// 可选。 数字值,该值指示要显示小数点右侧的多少位。 默认值为 -1,指示使用了区域设置。
//
// IncludeLeadingDigit:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示是否显示小数值前的零。 请参阅“设置”,以获取值。
//
// UseParensForNegativeNumbers:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示是否在括号内放入负值。 请参阅“设置”,以获取值。
//
// GroupDigits:
// 可选。 Microsoft.VisualBasic.TriState 常量,指示是否使用区域设置中指定的组分隔符对数字进行分组。 请参阅“设置”,以获取值。
//
// 返回结果:
// 以 % 字符结尾的百分比格式(即乘以 100)的表达式。
//
// 异常:
// T:System.InvalidCastException:
// 不是数字类型。
public static string FormatPercent(object Expression, int NumDigitsAfterDecimal = -1, TriState IncludeLeadingDigit = TriState.UseDefault, TriState UseParensForNegativeNumbers = TriState.UseDefault, TriState GroupDigits = TriState.UseDefault);
//
// 摘要:
// 返回 Char 值,该值表示提供的字符串中位于指定的索引位置处的字符。
//
// 参数:
// str:
// 必需。 任何有效的 String 表达式。
//
// Index:
// 必需。 Integer 表达式。 要返回的 str 中的字符索引(从 1 开始)。
//
// 返回结果:
// Char 值,该值表示提供的字符串中指定索引处的字符。
//
// 异常:
// T:System.ArgumentException:
// str 为 Nothing,Index < 1,或 Index 大于 str 最后一个字符的索引。
public static char GetChar(string str, int Index);
//
// 摘要:
// 返回一个整数,该整数指定一个字符串在另一个字符串中的第一个匹配项的起始位置。
//
// 参数:
// Start:
// 可选。 数值表达式,设置每个搜索的起始位置。 如果省略该参数,则从第一个字符位置开始搜索。 起始索引从一开始。
//
// String1:
// 必需。 正在搜索的 String 表达式。
//
// String2:
// 必需。 查找到的 String 表达式。
//
// Compare:
// 可选。 指定字符串比较的类型。 如果省略 Compare,则由 Option Compare 设置确定比较类型。
//
// 返回结果:
// 如果 InStr 返回 String1 的长度为零或 Nothing 0 String2 的长度为零或 Nothingstart 未找到 String2。
// 0 在 String2 中找到 String1 匹配开始的位置 Start 长度大于 String1 0
//
// 异常:
// T:System.ArgumentException:
// Start < 1。
public static int InStr(int Start, string String1, string String2, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回一个整数,该整数指定一个字符串在另一个字符串中的第一个匹配项的起始位置。
//
// 参数:
// String1:
// 必需。 正在搜索的 String 表达式。
//
// String2:
// 必需。 查找到的 String 表达式。
//
// Compare:
// 可选。 指定字符串比较的类型。 如果省略 Compare,则由 Option Compare 设置确定比较类型。
//
// 返回结果:
// 如果 InStr 返回 String1 的长度为零或 Nothing 0 String2 的长度为零或 Nothing 搜索的开始位置,该位置默认为第一个字符位置。
// 未找到 String2。 0 在 String2 中找到 String1 匹配开始的位置
public static int InStr(string String1, string String2, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回某一字符串从另一字符串的右侧开始算起第一次出现的位置。
//
// 参数:
// StringCheck:
// 必需。 搜索的 String 表达式。
//
// StringMatch:
// 必需。 搜索的字符串表达式。
//
// Start:
// 可选。 数值表达式,设置从字符串左侧开始进行的每个搜索的起始位置(从一开始计数)。 如果省略 Start,则使用 -1,它表示搜索从最后一个字符位置开始。
// 然后搜索从右到左继续进行。
//
// Compare:
// 可选。 数值,指示对子字符串求值时使用的比较类型。 如果省略,就会执行二进制比较。 具体的值请参见"设置"。
//
// 返回结果:
// 如果 InStrRev 返回 StringCheck 的长度为零 0 StringMatch 的长度为零 Start 未找到 StringMatch。 0
// 在 StringMatch 中找到 StringCheck 从字符串的右侧开始找到的第一个匹配项的位置。 Start 大于 StringMatch 的长度
// 0
//
// 异常:
// T:System.ArgumentException:
// Start = 0 或 Start < -1。
public static int InStrRev(string StringCheck, string StringMatch, int Start = -1, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回通过连接一个数组中包含的若干子字符串创建的字符串。
//
// 参数:
// SourceArray:
// 必需。 一维数组,包含要连接的子字符串。
//
// Delimiter:
// 可选。 任何字符串,用于在返回的字符串中分隔子字符串。 如果省略该参数,则使用空白字符 (" ")。 如果 Delimiter 是零长度字符串 ("")
// 或 Nothing,则列表中的所有项目都串联在一起,中间没有分隔符。
//
// 返回结果:
// 通过连接一个数组中包含的若干子字符串创建的字符串。
//
// 异常:
// T:System.ArgumentException:
// SourceArray 不是一维数组。
public static string Join(string[] SourceArray, string Delimiter = " ");
//
// 摘要:
// 返回通过连接一个数组中包含的若干子字符串创建的字符串。
//
// 参数:
// SourceArray:
// 必需。 一维数组,包含要连接的子字符串。
//
// Delimiter:
// 可选。 任何字符串,用于在返回的字符串中分隔子字符串。 如果省略该参数,则使用空白字符 (" ")。 如果 Delimiter 是零长度字符串 ("")
// 或 Nothing,则列表中的所有项目都串联在一起,中间没有分隔符。
//
// 返回结果:
// 通过连接一个数组中包含的若干子字符串创建的字符串。
//
// 异常:
// T:System.ArgumentException:
// SourceArray 不是一维数组。
public static string Join(object[] SourceArray, string Delimiter = " ");
//
// 摘要:
// 返回将转换为小写的字符串或字符。
//
// 参数:
// Value:
// 必需。 任何有效的 String 或 Char 表达式。
//
// 返回结果:
// 将转换为小写的字符串或字符。
public static char LCase(char Value);
//
// 摘要:
// 返回将转换为小写的字符串或字符。
//
// 参数:
// Value:
// 必需。 任何有效的 String 或 Char 表达式。
//
// 返回结果:
// 将转换为小写的字符串或字符。
public static string LCase(string Value);
//
// 摘要:
// 返回一个字符串,该字符串包含从某字符串左侧算起的指定数量的字符。
//
// 参数:
// str:
// 必需。 一个 String 表达式,从中返回最左侧的那些字符。
//
// Length:
// 必需。 Integer 表达式。 指示要返回的字符数的数值表达式。 如果为 0,则返回零长度字符串 ("")。 如果大于或等于 str 的字符数,则返回整个字符串。
//
// 返回结果:
// 一个字符串,该字符串包含从某字符串左侧算起的指定数量的字符。
//
// 异常:
// T:System.ArgumentException:
// Length < 0。
public static string Left(string str, int Length);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(DateTime Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
[SecuritySafeCritical]
public static int Len(object Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(string Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(double Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(char Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(decimal Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(byte Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(short Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
[CLSCompliant(false)]
public static int Len(ushort Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(int Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
[CLSCompliant(false)]
public static int Len(uint Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(float Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
[CLSCompliant(false)]
public static int Len(sbyte Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(bool Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
public static int Len(long Expression);
//
// 摘要:
// 返回一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
//
// 参数:
// Expression:
// 任何有效的 String 表达式或变量名。 如果 Expression 为 Object 类型,Len 函数将返回其在由 FilePut 函数写入文件中时的大小。
//
// 返回结果:
// 一个包含字符串中的字符数或存储某个变量所需的名义字节数的整数。
[CLSCompliant(false)]
public static int Len(ulong Expression);
//
// 摘要:
// 返回一个左对齐字符串,该字符串包含调整为指定长度的指定的字符串。
//
// 参数:
// Source:
// 必需。 String 表达式。 字符串变量的名称。
//
// Length:
// 必需。 Integer 表达式。 返回的字符串的长度。
//
// 返回结果:
// 一个左对齐字符串,该字符串包含调整为指定长度的指定的字符串。
public static string LSet(string Source, int Length);
//
// 摘要:
// 返回一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
//
// 参数:
// str:
// 必需。 任何有效的 String 表达式。
//
// 返回结果:
// 一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
public static string LTrim(string str);
//
// 摘要:
// 返回字符串,该字符串包含从字符串中的指定位置开始的指定数量的字符。
//
// 参数:
// str:
// 必需。 String 表达式,从该表达式返回字符。
//
// Start:
// 必需。 Integer 表达式。 要返回字符的开始位置。 如果 Start 大于 str 中的字符个数,则 Mid 函数返回零长度字符串 ("")。 Start
// 从 1 开始。
//
// Length:
// 可选。 Integer 表达式。 要返回的字符数。 如果 Length 省略或超过文本的字符(包括 Start 处的字符)数,则返回从字符串开始位置到结尾的所有字符。
//
// 返回结果:
// 由从字符串中指定位置开始的指定数量的字符组成的字符串。
//
// 异常:
// T:System.ArgumentException:
// Start <= 0 或 Length < 0。
public static string Mid(string str, int Start, int Length);
//
// 摘要:
// 返回字符串,该字符串包含从字符串中的指定位置开始的所有字符。
//
// 参数:
// str:
// 必需。 String 表达式,从该表达式返回字符。
//
// Start:
// 必需。 Integer 表达式。 要返回字符的开始位置。 如果 Start 大于 str 中的字符个数,则 Mid 函数返回零长度字符串 ("")。 Start
// 从一开始。
//
// 返回结果:
// 由从字符串中指定位置开始的所有字符组成的字符串。
//
// 异常:
// T:System.ArgumentException:
// Start <= 0 或 Length < 0。
public static string Mid(string str, int Start);
//
// 摘要:
// 返回一个字符串,其中的指定子字符串已由另一个子字符串替换了指定的次数。
//
// 参数:
// Expression:
// 必需。 字符串表达式,包含要替换的子字符串。
//
// Find:
// 必需。 搜索的子字符串。
//
// Replacement:
// 必需。 替换用的子字符串。
//
// Start:
// 可选。 Expression 内部要替换的子字符串的开始的位置。 Replace 的返回值是字符串,在 Start 开始,具有相应的子情况。 如果省略,则假定为
// 1。
//
// Count:
// 可选。 执行子字符串替换的数目。 如果省略,则默认值是 -1,表示“进行所有可能的替换”。
//
// Compare:
// 可选。 数值,指示对子字符串求值时使用的比较类型。 具体的值请参见"设置"。
//
// 返回结果:
// Replace 返回下列值。 如果 Replace 返回 Find 的长度为零或 NothingExpression 的副本Replace 的长度为零 Expression
// 的副本,不带 Find 匹配项Expression 的长度为零或 Nothing,或者 Start 大于 Expression 的长度NothingCount
// 是 0 Expression 的副本
//
// 异常:
// T:System.ArgumentException:
// Count < -1 或 Start <= 0。
public static string Replace(string Expression, string Find, string Replacement, int Start = 1, int Count = -1, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回一个字符串,其中包含从某个字符串右端开始的指定数量的字符。
//
// 参数:
// str:
// 必需。 一个 String 表达式,从中返回最右侧的那些字符。
//
// Length:
// 必需。 Integer。 指示要返回的字符数的数值表达式。 如果为 0,则返回零长度字符串 ("")。 如果大于或等于 str 的字符数,则返回整个字符串。
//
// 返回结果:
// 一个字符串,其中包含从某个字符串右端开始的指定数量的字符。
//
// 异常:
// T:System.ArgumentException:
// Length < 0。
public static string Right(string str, int Length);
//
// 摘要:
// 返回包含调整为指定长度的指定字符串的右对齐字符串。
//
// 参数:
// Source:
// 必需。 String 表达式。 字符串变量的名称。
//
// Length:
// 必需。 Integer 表达式。 返回的字符串的长度。
//
// 返回结果:
// 包含调整为指定长度的指定字符串的右对齐字符串。
public static string RSet(string Source, int Length);
//
// 摘要:
// 返回一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
//
// 参数:
// str:
// 必需。 任何有效的 String 表达式。
//
// 返回结果:
// 一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
public static string RTrim(string str);
//
// 摘要:
// 返回由指定数量空格组成的字符串。
//
// 参数:
// Number:
// 必需。 Integer 表达式。 希望字符串包含的空格数。
//
// 返回结果:
// 由指定数量空格组成的字符串。
//
// 异常:
// T:System.ArgumentException:
// Number < 0。
public static string Space(int Number);
//
// 摘要:
// 返回一个从零开始的一维数组,其中包含指定数量的子字符串。
//
// 参数:
// Expression:
// 必需。 包含子字符串和分隔符的 String 表达式。
//
// Delimiter:
// 可选。 用于标识子字符串的界限的任何单个字符。 如果省略了 Delimiter,则假定空白字符 (" ") 为分隔符。
//
// Limit:
// 可选。 输入字符串应拆分到的子字符串的最大数量。 默认值为 -1,指示在 Delimiter 字符串的每个匹配项处都拆分输入字符串。
//
// Compare:
// 可选。 数值,指示计算子字符串时使用的比较模式。 请参阅“设置”,以获取值。
//
// 返回结果:
// String 数组。 如果 Expression 为零长度字符串 (""),则 Split 返回包含零长度字符串的单个元素数组。 如果 Delimiter
// 为零长度字符串,或如果它不在 Expression 中的任何位置出现,则 Split 将返回包含整个 Expression 字符串的单个元素数组。
public static string[] Split(string Expression, string Delimiter = " ", int Limit = -1, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 根据字符串的比较结果返回 -1、0 或 1。
//
// 参数:
// String1:
// 必需。 任何有效的 String 表达式。
//
// String2:
// 必需。 任何有效的 String 表达式。
//
// Compare:
// 可选。 指定字符串比较的类型。 如果省略 Compare,则由 Option Compare 设置确定比较类型。
//
// 返回结果:
// StrComp 函数具有下列返回值: 如果 StrComp 返回 String1 排在 String2 的前面 -1 String1 等于 String2
// 0 String1 排在 String2 的后面 1
//
// 异常:
// T:System.ArgumentException:
// Compare 值无效。
public static int StrComp(string String1, string String2, [OptionCompare] CompareMethod Compare = CompareMethod.Binary);
//
// 摘要:
// 返回按照指定方式转换的字符串。
//
// 参数:
// str:
// 必需。 要转换的 String 表达式。
//
// Conversion:
// 必需。 Microsoft.VisualBasic.VbStrConv 成员。 指定要执行的转换类型的枚举值。
//
// LocaleID:
// 可选。 LocaleID 值(如果与系统 LocaleID 值不同)。 (系统 LocaleID 值为默认值。)
//
// 返回结果:
// 按照指定方式转换的字符串。
//
// 异常:
// T:System.ArgumentException:
// 不支持 LocaleID、Conversion < 0 或 > 2048,或不支持指定区域设置的转换。
public static string StrConv(string str, VbStrConv Conversion, int LocaleID = 0);
//
// 摘要:
// 返回由指定字符重复指定次数后形成的字符串或对象。
//
// 参数:
// Number:
// 必需。 Integer 表达式。 要返回的字符串的长度。
//
// Character:
// 必需。 任何有效的 Char、String 或 Object 表达式。 将只使用表达式的第一个字符。 如果字符类型是 Object,则它必须包含一个 Char
// 或 String 值。
//
// 返回结果:
// 由指定字符重复指定次数后形成的字符串或对象。
//
// 异常:
// T:System.ArgumentException:
// Number 小于 0 或 Character 类型无效。
//
// T:System.ArgumentNullException:
// Character 为 Nothing。
public static string StrDup(int Number, string Character);
//
// 摘要:
// 返回由指定字符重复指定次数后形成的字符串或对象。
//
// 参数:
// Number:
// 必需。 Integer 表达式。 要返回的字符串的长度。
//
// Character:
// 必需。 任何有效的 Char、String 或 Object 表达式。 将只使用表达式的第一个字符。 如果字符类型是 Object,则它必须包含一个 Char
// 或 String 值。
//
// 返回结果:
// 由指定字符重复指定次数后形成的字符串或对象。
//
// 异常:
// T:System.ArgumentException:
// Number 小于 0 或 Character 类型无效。
//
// T:System.ArgumentNullException:
// Character 为 Nothing。
public static string StrDup(int Number, char Character);
//
// 摘要:
// 返回由指定字符重复指定次数后形成的字符串或对象。
//
// 参数:
// Number:
// 必需。 Integer 表达式。 要返回的字符串的长度。
//
// Character:
// 必需。 任何有效的 Char、String 或 Object 表达式。 将只使用表达式的第一个字符。 如果字符类型是 Object,则它必须包含一个 Char
// 或 String 值。
//
// 返回结果:
// 由指定字符重复指定次数后形成的字符串或对象。
//
// 异常:
// T:System.ArgumentException:
// Number 小于 0 或 Character 类型无效。
//
// T:System.ArgumentNullException:
// Character 为 Nothing。
public static object StrDup(int Number, object Character);
//
// 摘要:
// 返回指定字符串的字符顺序是相反的字符串。
//
// 参数:
// Expression:
// 必需。 字符反转的字符串表达式。 如果 Expression 是一个零长度字符串 (""),则返回一个零长度字符串。
//
// 返回结果:
// 指定字符串的字符顺序是相反的字符串。
public static string StrReverse(string Expression);
//
// 摘要:
// 返回一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
//
// 参数:
// str:
// 必需。 任何有效的 String 表达式。
//
// 返回结果:
// 一个字符串,它包含一个没有前导空格 (LTrim)、没有尾随空格 (RTrim) 或既没有前导空格也没有尾随空格 (Trim) 的指定字符串的副本。
public static string Trim(string str);
//
// 摘要:
// 返回一个字符串或字符,其中包含转换为大写的指定字符串。
//
// 参数:
// Value:
// 必需。 任何有效的 String 或 Char 表达式。
//
// 返回结果:
// 一个字符串或字符,其中包含转换为大写的指定字符串。
public static string UCase(string Value);
//
// 摘要:
// 返回一个字符串或字符,其中包含转换为大写的指定字符串。
//
// 参数:
// Value:
// 必需。 任何有效的 String 或 Char 表达式。
//
// 返回结果:
// 一个字符串或字符,其中包含转换为大写的指定字符串。
public static char UCase(char Value);
}
}