StringBuilder.AppendLine Método

Definição

Namespace:: System.Text

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Acrescenta o terminador de linha padrão ou uma cópia de uma cadeia de caracteres especificada e o terminador de linha padrão ao final desta instância.

Sobrecargas

Nome	Description
AppendLine()	Acrescenta o terminador de linha padrão ao final do objeto atual StringBuilder .
AppendLine(String)	Acrescenta uma cópia da cadeia de caracteres especificada seguida pelo terminador de linha padrão ao final do objeto atual StringBuilder .
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Acrescenta a cadeia de caracteres interpolada especificada seguida pelo terminador de linha padrão ao final do objeto StringBuilder atual.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Acrescenta a cadeia de caracteres interpolada especificada usando o formato especificado, seguido pelo terminador de linha padrão, até o final do objeto StringBuilder atual.

AppendLine()

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Acrescenta o terminador de linha padrão ao final do objeto atual StringBuilder .

public:
 System::Text::StringBuilder ^ AppendLine();

public System.Text.StringBuilder AppendLine();

[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine();

member this.AppendLine : unit -> System.Text.StringBuilder

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.AppendLine : unit -> System.Text.StringBuilder

Public Function AppendLine () As StringBuilder

Retornos

StringBuilder

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos: ComVisibleAttribute

Exceções

ArgumentOutOfRangeException

A ampliação do valor dessa instância excederia MaxCapacity.

Exemplos

O exemplo a seguir demonstra o AppendLine método.

// 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.
*/

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

open System.Text

let sb = StringBuilder()
let line = "A line of text."
let number = 123

// Append two lines of text.
sb.AppendLine "The first line of text." |> ignore
sb.AppendLine line |> ignore

// Append a new line, an empty string, and a null cast as a string.
sb.AppendLine() |> ignore
sb.AppendLine "" |> ignore
sb.AppendLine Unchecked.defaultof<string> |> ignore

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

// Append two lines of text.
sb.AppendLine line |> ignore
sb.AppendLine "The last line of text." |> ignore

// Convert the value of the StringBuilder to a string and display the string.
printfn $"{sb}"

// 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.

' This example demonstrates the StringBuilder.AppendLine() 
' method.
Imports System.Text

Class Sample
   Public Shared Sub Main()
      Dim sb As New StringBuilder()
      Dim line As String = "A line of text."
      Dim number As Integer = 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(CStr(Nothing))
      
      ' 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())
   End Sub
End Class
'
'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.

Comentários

O terminador de linha padrão é o valor atual da Environment.NewLine propriedade.

A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você instancia o StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, tanto o comprimento quanto a capacidade da StringBuilder instância podem crescer além do valor de sua MaxCapacity propriedade. Isso pode ocorrer especialmente quando você chama e Append(String)AppendFormat(String, Object) os métodos para acrescentar cadeias de caracteres pequenas.

Confira também

String

Aplica-se a

AppendLine(String)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Acrescenta uma cópia da cadeia de caracteres especificada seguida pelo terminador de linha padrão ao final do objeto atual StringBuilder .

public:
 System::Text::StringBuilder ^ AppendLine(System::String ^ value);

public System.Text.StringBuilder AppendLine(string value);

public System.Text.StringBuilder AppendLine(string? value);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine(string value);

member this.AppendLine : string -> System.Text.StringBuilder

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.AppendLine : string -> System.Text.StringBuilder

Public Function AppendLine (value As String) As StringBuilder

Parâmetros

value: String

A cadeia de caracteres a ser acrescentada.

Retornos

StringBuilder

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos: ComVisibleAttribute

Exceções

ArgumentOutOfRangeException

A ampliação do valor dessa instância excederia MaxCapacity.

Comentários

O terminador de linha padrão é o valor atual da Environment.NewLine propriedade.

A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

String

Aplica-se a

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Acrescenta a cadeia de caracteres interpolada especificada seguida pelo terminador de linha padrão ao final do objeto StringBuilder atual.

public:
 System::Text::StringBuilder ^ AppendLine(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder AppendLine(ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.AppendLine : AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function AppendLine (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parâmetros

handler: StringBuilder.AppendInterpolatedStringHandler

A cadeia de caracteres interpolada a ser acrescentada.

Retornos

StringBuilder

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Acrescenta a cadeia de caracteres interpolada especificada usando o formato especificado, seguido pelo terminador de linha padrão, até o final do objeto StringBuilder atual.

public:
 System::Text::StringBuilder ^ AppendLine(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder AppendLine(IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.AppendLine : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function AppendLine (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parâmetros

provider: IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

handler: StringBuilder.AppendInterpolatedStringHandler

A cadeia de caracteres interpolada a ser acrescentada.

Retornos

StringBuilder

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Comentários

Esta página foi útil?

Compartilhar via

StringBuilder.AppendLine Método

Definição

Sobrecargas

AppendLine()

Retornos

Exceções

Exemplos

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

AppendLine(String)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Parâmetros

Retornos

Aplica-se a

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parâmetros

Retornos

Aplica-se a

Comentários