このドキュメントはアーカイブされており、メンテナンスされていません。

StringBuilder.Append メソッド (Char[], Int32, Int32)

Unicode 文字の指定した部分配列の文字列形式をこのインスタンスの末尾に追加します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)

public StringBuilder Append (
	char[] value,
	int startIndex,
	int charCount
)
public StringBuilder Append (
	char[] value, 
	int startIndex, 
	int charCount
)
public function Append (
	value : char[], 
	startIndex : int, 
	charCount : int
) : StringBuilder
適用できません。

パラメータ

value

文字配列。

startIndex

value 内の開始位置。

charCount

追加する文字数。

戻り値

追加操作が完了した後のこのインスタンスへの参照。

例外の種類条件

ArgumentNullException

value が null 参照 (Visual Basic では Nothing) であり、startIndexcharCount が 0 以外の値です。

ArgumentOutOfRangeException

charCount が 0 未満です。

または

startIndex が 0 未満です。

または

startIndexcharCount を加算した値が、value の長さより小さい値です。

または

このインスタンスの値を増やすと、MaxCapacity を超えます。

このメソッドは、value 内の指定した範囲の文字を現在のインスタンスに追加します。value が null 参照 (Visual Basic では Nothing) であり、startIndexcount がいずれも 0 の場合、変更は実行されません。

このインスタンスの容量は、必要に応じて調整されます。

using System;
using System.Text;

class Sample 
{
    public static void Main() 
    {
    string      sep       = ", ";
    string      head      = "<<<";
    char[]      tail      = {'>', '>', '>'};
    char        dash      = '-';
    Object 	obj       = 0;

    bool        xBool     = true;
    byte        xByte     = 1;
    short       xInt16    = 2;
    int         xInt32    = 3;
    long        xInt64    = 4;
    Decimal     xDecimal  = 5;
    float       xSingle   = 6.6F;
    double      xDouble   = 7.7;

// The following types are not CLS-compliant.
    ushort      xUInt16   = 8;
    uint        xUInt32   = 9;
    ulong       xUInt64   = 10;
    sbyte       xSByte    = -11;
//
    StringBuilder sb = new StringBuilder();

    sb = sb.Append(head);                // <<<
    sb = sb.Append(head, 2, 1);          // <<<<
    sb = sb.Append(dash);                // <<<<-
    sb = sb.Append(dash).Append(dash);   // <<<<---

    sb = sb.Append(xBool).Append(sep);
    sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep);
    sb = sb.Append(xInt16);
    sb = sb.Append(sep);
    sb = sb.Append(xInt32);
    sb = sb.Append(sep);
    sb = sb.Append(xInt64);
    sb = sb.Append(sep);
    sb = sb.Append(xDecimal).Append(sep);
    sb = sb.Append(xSingle).Append(sep).Append(xDouble).Append(sep);

// The following Append methods are not CLS-compliant.
    sb = sb.Append(xUInt16).Append(sep);
    sb = sb.Append(xUInt32).Append(sep).Append(xUInt64).Append(sep);
    sb = sb.Append(xSByte);
//
    sb = sb.Append(dash, 3);             // ---
    sb = sb.Append(tail);                // --->>>
    sb = sb.Append(tail, 2, 1);          // --->>>>
   
    String str = sb.ToString();
    Console.WriteLine("The appended string is:");
    Console.WriteLine(str);
    }
}
/*
This example produces the following results:
The appended string is:
<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>>
*/

// This example demonstrates StringBuilder.Append()
import System.*;
import System.Text.*;

class Sample
{
    public static void main(String[] args)
    {
        String sep = ", ";
        String head = "<<<";
        char tail[] =  { '>', '>', '>' };
        char dash = '-';
        Object obj = new Integer(0);

        boolean xBool = true;
        ubyte xByte = 1;
        short xInt16 = 2;
        int xInt32 = 3;
        long xInt64 = 4;
        Decimal xDecimal = new Decimal(5);
        float xSingle = 6.6f;
        double xDouble = 7.7;
        // The following types are not CLS-compliant.
        int xUInt16 = 8;
        int xUInt32 = 9;
        long xUInt64 = 10;
        byte xSByte = -11;
        //
        StringBuilder sb = new StringBuilder();

        sb = sb.Append(head); // <<<
        sb = sb.Append(head, 2, 1); // <<<<
        sb = sb.Append(dash); // <<<<-
        sb = sb.Append(dash).Append(dash); // <<<<---
        sb = sb.Append(xBool).Append(sep);
        sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep);
        sb = sb.Append(xInt16);
        sb = sb.Append(sep);
        sb = sb.Append(xInt32);
        sb = sb.Append(sep);
        sb = sb.Append(xInt64);
        sb = sb.Append(sep);
        sb = sb.Append(xDecimal).Append(sep);
        sb = sb.Append(xSingle).Append(sep).Append(xDouble).Append(sep);
        // The following Append methods are not CLS-compliant.
        sb = sb.Append(xUInt16).Append(sep);
        sb = sb.Append(xUInt32).Append(sep).Append(xUInt64).Append(sep);
        sb = sb.Append(xSByte);
        //
        sb = sb.Append(dash, 3); // ---
        sb = sb.Append(tail); // --->>>
        sb = sb.Append(tail, 2, 1); // --->>>>
        String str = sb.ToString();
        Console.WriteLine("The appended string is:");
        Console.WriteLine(str);
    } //main
} //Sample
/*
This example produces the following results:
The appended string is:
<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>>
*/

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

.NET Compact Framework

サポート対象 : 2.0,1.0

XNA Framework

サポート対象 : 1.0
表示: