System.String.Join 方法 (String, String[], Int32, Int32)

方法描述

串联字符串数组的指定元素,其中在每个元素之间使用指定的分隔符。

语法定义(C# System.String.Join 方法 (String, String[], Int32, Int32) 的用法)

public static string Join(
	string separator,
	string[] value,
	int startIndex,
	int count
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
separator System-String 要用作分隔符的字符串。
value System-String[] 一个数组,其中包含要连接的元素。
startIndex System-Int32 value 中要使用的第一个元素。
count System-Int32 要使用的 value 的元素数。
返回值 System.String 由 value 中的字符串组成的字符串,这些字符串以 separator 字符串分隔。 - 或 - 如果 count 为零,value 没有元素,或 separator 以及 value 的全部元素均为 String.Empty,则为 String.Empty。

提示和注释

例如,如果 separator 为“,”且 value 的元素为“apple”、“orange”、“grape”和“pear”,则 Join(separator, value, 1, 2) 返回“orange, grape”。

如果 separator 为 null,则使用空字符串 (String.Empty)。 如果 value 中的任何值为 null,则使用空字符串。

System.String.Join 方法 (String, String[], Int32, Int32)例子

下面的示例连接水果名称数组中的两个元素。

// Sample for String.Join(String, String[], int int)
using System;

class Sample {
    public static void Main() {
    String[] val = {"apple", "orange", "grape", "pear"};
    String sep   = ", ";
    String result;

    Console.WriteLine("sep = '{0}'", sep);
    Console.WriteLine("val[] = {{'{0}' '{1}' '{2}' '{3}'}}", val[0], val[1], val[2], val[3]);
    result = String.Join(sep, val, 1, 2);
    Console.WriteLine("String.Join(sep, val, 1, 2) = '{0}'", result);
    }
}
/*
This example produces the following results:
sep = ', '
val[] = {'apple' 'orange' 'grape' 'pear'}
String.Join(sep, val, 1, 2) = 'orange, grape'
*/

异常

异常 异常描述
ArgumentNullException value 为 null。
ArgumentOutOfRangeException
  • startIndex 或 count 小于 0。
  • startIndex 加上 count 大于 value 中的元素数。
OutOfMemoryException 内存不足。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。