Cette documentation est archivée et n’est pas conservée.

StringBuilder.Append, méthode (Char[], Int32, Int32)

Ajoute à la fin de cette instance la représentation sous forme de chaîne d'un sous-tableau spécifié de caractères Unicode.

Espace de noms: System.Text
Assembly : mscorlib (dans 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
Non applicable.

Paramètres

value

Tableau de caractères.

startIndex

Position de départ dans value.

charCount

Nombre de caractères à ajouter.

Valeur de retour

Référence à cette instance après l'opération d'ajout.

Type d'exceptionCondition

ArgumentNullException

value est référence Null (Nothing en Visual Basic), et startIndex comme charCount sont différents de zéro.

ArgumentOutOfRangeException

charCount est inférieur à zéro.

- ou -

startIndex est inférieur à zéro.

- ou -

startIndex + charCount est inférieur à la longueur de value.

- ou -

Une augmentation de la valeur de cette instance entraînerait un dépassement de MaxCapacity.

Cette méthode ajoute la plage spécifiée de caractères de value à l'instance actuelle. Si value est référence Null (Nothing en Visual Basic) et que startIndex comme count sont égaux à zéro, aucune modification n'est effectuée.

La capacité de cette instance est ajustée si nécessaire.

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 Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

XNA Framework

Prise en charge dans : 1.0
Afficher: