System.Console.WriteLine 方法 (String, Object, Object, Object, Object, ...)

方法描述

使用指定的格式信息,将指定的对象和可变长度参数列表(后跟当前行终止符)的文本表示形式写入标准输出流。

语法定义(C# System.Console.WriteLine 方法 (String, Object, Object, Object, Object, ...) 的用法)

C#不支持使用可变长度参数 (varargs) 的方法。
编译器会自动将对此方法的调用解析为使用参数数据的同一方法。

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
format System-String 符合格式字符串(参见“备注”)。
arg0 System-Object 要使用 format 写入的第一个对象。
arg1 System-Object 要使用 format 写入的第二个对象。
arg2 System-Object 要使用 format 写入的第三个对象。
arg3 System-Object 要使用 format 写入的第四个对象。
返回值 void

提示和注释

此方法使用 .NET Framework 的复合格式设置功能将对象的值转换为其文本表示形式,并将该表示形式嵌入字符串中。 得到的字符串被写入输出流。

format 参数由零或多个文本序列与零或多个索引占位符混合组成,其中索引占位符称为格式项,对应于与此方法的参数列表中的对象。 格式设置过程将每个格式项替换为相应对象值的文本表示形式。

格式项的语法是 {索引[,对齐方式][:格式字符串]},它指定了一个强制索引、格式化文本的可选长度和对齐方式,以及格式说明符字符的可选字符串,其中格式说明符字符用于控制如何设置相应对象的值的格式。

.NET Framework 提供了广泛的格式设置支持,下面的格式设置主题中对此有更详细的描述。

有关 Format、AppendFormat 等方法以及 WriteLine 的某些重载所支持的复合格式设置功能的更多信息,请参见复合格式。

有关数值格式说明符的更多信息,请参见标准数字格式字符串和自定义数字格式字符串。

有关日期和时间格式说明符的更多信息,请参见标准日期和时间格式字符串和自定义日期和时间格式字符串。

有关枚举格式说明符的更多信息,请参见枚举格式字符串。

有关格式设置的更多信息,请参见格式化类型。

有关行终止符的更多信息,请参见不使用任何参数的 WriteLine 方法的“备注”部分。

注意

应用到此类型或成员的 HostProtectionAttribute 特性具有以下 Resources 属性值:UI。HostProtectionAttribute 不影响桌面应用程序(桌面应用程序一般通过双击图标、键入命令或在浏览器中输入 URL 启动)。有关更多信息,请参见 HostProtectionAttribute 类或 SQL Server 编程和宿主保护特性。

对调用者的说明

此方法标有 vararg 关键字,这意味着它支持的参数数目可变。 可以从 Visual C++ 中调用该方法,但不能从 C# 或 Visual Basic 代码调用。 C# 和 Visual Basic 编译器将对 WriteLine(String, Object, Object, Object, Object) 的调用解析为对 WriteLine(String, Object[]) 的调用。

System.Console.WriteLine 方法 (String, Object, Object, Object, Object, ...)例子

使用一个复合格式字符串和五个格式项调用该方法。

using namespace System;

void main()
{
   DateTime dateRecorded(2009, 6, 15);
   DateTime startTime(1, 1, 1, 0, 30, 0);
   TimeSpan interval(12, 0, 0);

   Double temperature1 = 52.8;
   Double temperature2 = 63.5;

   Console::WriteLine("Date: {0:d}:\n   Temperature at {1:t}: {2}\n   Temperature at {3:t}: {4}\n", 
                     dateRecorded, startTime, temperature1, 
                     startTime.Add(interval), temperature2);
    Console::ReadLine();
}
// The example displays the following output:
//      Date: 6/15/2009:
//         Temperature at 12:30 AM: 52.8
//         Temperature at 12:30 PM: 63.5

异常

异常 异常描述
IOException 发生了 I/O 错误。
ArgumentNullException format 为 null。
FormatException format 中的格式规范无效。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。