System.String.ToCharArray 方法 (Int32, Int32)

方法描述

将此实例中的指定子字符串内的字符复制到 Unicode 字符数组。

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

public char[] ToCharArray(
	int startIndex,
	int length
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
startIndex System-Int32 此实例内子字符串的起始位置。
length System-Int32 此实例内子字符串的长度。
返回值 System.Char[] 元素为此实例中从字符位置 startIndex 开始的 length 字符数的 Unicode 字符数组。

提示和注释

startIndex 参数从零开始。 也就是说,字符串实例中第一个字符的索引为零。

如果 length 为零,则返回的数组为空,其长度为零。 如果此实例为 null 或空字符串 (""),则返回的数组为空,其长度为零。

System.String.ToCharArray 方法 (Int32, Int32)例子

下面的示例将字符串中的子字符串转换为字符数组,然后枚举并显示该数组的元素。

// Sample for String.ToCharArray(Int32, Int32)
using System;

class Sample {
    public static void Main() {
    string str = "012wxyz789";
    char[] arr;

    arr = str.ToCharArray(3, 4);
    Console.Write("The letters in '{0}' are: '", str);
    Console.Write(arr);
    Console.WriteLine("'");
    Console.WriteLine("Each letter in '{0}' is:", str);
    foreach (char c in arr)
        Console.WriteLine(c);
    }
}
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

异常

异常 异常描述
ArgumentOutOfRangeException
  • startIndex 或 length 小于零。
  • startIndex 加上 length 大于此实例的长度。

命名空间

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 系统要求。