Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

StringBuilder.AppendLine, méthode

Ajoute la marque de fin de ligne par défaut à la fin de l'objet StringBuilder en cours.

Espace de noms :  System.Text
Assembly :  mscorlib (dans mscorlib.dll)
[ComVisibleAttribute(false)]
public StringBuilder AppendLine()

Valeur de retour

Type : System.Text.StringBuilder
Référence à cette instance après l'opération d'ajout.
ExceptionCondition
ArgumentOutOfRangeException

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

La marque de fin de ligne par défaut est la valeur en cours de la propriété Environment.NewLine.

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

Remarques à l'attention des appelants

Dans .NET Framework 4 et .NET Framework 4.5, lorsque vous instanciez l'objet StringBuilder en appelant le constructeur de StringBuilder(Int32, Int32), la longueur et l'instance d'StringBuilder peuvent développer au delà de la valeur de sa propriété d'MaxCapacity. Cela peut se produire en particulier lorsque vous appelez les méthodes d'Append et AppendFormat pour ajouter de petites chaînes.

L'exemple de code suivant illustre la méthode AppendLine.


// This example demonstrates the StringBuilder.AppendLine() 
// method.

using System;
using System.Text;

class Sample 
{
    public static void Main() 
    {
    StringBuilder sb = new StringBuilder();
    string        line = "A line of text.";
    int           number = 123;

// Append two lines of text.
    sb.AppendLine("The first line of text.");
    sb.AppendLine(line);

// Append a new line, an empty string, and a null cast as a string.
    sb.AppendLine();
    sb.AppendLine("");
    sb.AppendLine((string)null);

// Append the non-string value, 123, and two new lines.
    sb.Append(number).AppendLine().AppendLine();

// Append two lines of text.
    sb.AppendLine(line);
    sb.AppendLine("The last line of text.");

// Convert the value of the StringBuilder to a string and display the string.
    Console.WriteLine(sb.ToString());
    }
}
/*
This example produces the following results:

The first line of text.
A line of text.



123

A line of text.
The last line of text.
*/


.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft. Tous droits réservés.