Export (0) Print
Expand All

Environment.NewLine Property

Gets the newline string defined for this environment.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static string NewLine { get; }
/** @property */
public static String get_NewLine ()

public static function get NewLine () : String

Not applicable.

Property Value

A string containing "\r\n" for non-Unix platforms, or a string containing "\n" for Unix platforms.

The property value of NewLine is a constant customized specifically for the current platform and implementation of the .NET Framework. For more information about the escape characters in the property value, see Character Escapes.

The functionality provided by NewLine is often what is meant by the terms newline, line feed, line break, carriage return, CRLF, and end of line.

NewLine can be used in conjunction with language-specific newline support such as the escape characters '\r' and '\n' in Microsoft C# and C/C++, or vbCrLf in Microsoft Visual Basic.

NewLine is automatically appended to text processed by the System.Console.WriteLine and System.Text.StringBuilder.AppendLine methods.

The following code example displays three lines separated by newlines.

// Sample for the Environment.NewLine property
using System;

class Sample 
{
    public static void Main() 
    {
    Console.WriteLine();
    Console.WriteLine("NewLine: {0}  first line{0}  second line{0}  third line",
                          Environment.NewLine);
    }
}
/*
This example produces the following results:

NewLine:
  first line
  second line
  third line
*/

// Sample for the Environment.NewLine property
import System.*;

class Sample
{
    public static void main(String[] args)
    {
        Console.WriteLine();
        Console.WriteLine("NewLine: {0}  first line{0}  second line{0}"
            + "  third line", Environment.get_NewLine());
    } //main
} //Sample
/*
This example produces the following results:

NewLine:
  first line
  second line
  third line
*/

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft