HtmlTextWriter.WriteLine 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

按照重载参数的指定，将数据写入到 HtmlTextWriter 输出流，并在后面跟上一个行结束符字符串。 此方法的所有版本均将任何挂起的制表符间距写入到输出流。

重载

WriteLine(String, Object, Object)	将任何挂起的制表符间距和包含两个对象的文本表示形式的格式化字符串写入到输出流，并在后面跟上行结束符字符串。
WriteLine(Char[], Int32, Int32)	将任何挂起的制表符间距和一个 Unicode 字符子数组写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(String, Object[])	将任何挂起的制表符间距和一个包含对象数组的文本表示形式的格式化字符串写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(String, Object)	将任何挂起的制表符间距和一个包含一个对象的文本表示形式的格式化字符串写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(UInt32)	将任何挂起的制表符间距和一个 4 字节无符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(String)	将任何挂起的制表符间距和一个文本字符串写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Single)	将任何挂起的制表符间距和一个单精度浮点数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Int32)	将任何挂起的制表符间距和一个 32 字节有符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Int64)	将任何挂起的制表符间距和一个 64 字节有符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Double)	将任何挂起的制表符间距和一个双精度浮点数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Char[])	将任何挂起的制表符间距和一个 Unicode 字符数组写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Char)	将任何挂起的制表符间距和一个 Unicode 字符写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine(Boolean)	将任何挂起的制表符间距和一个布尔值的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。
WriteLine()	将行结束符字符串写入到输出流。
WriteLine(Object)	将任何挂起的制表符间距和一个对象的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

WriteLine(String, Object, Object)

将任何挂起的制表符间距和包含两个对象的文本表示形式的格式化字符串写入到输出流，并在后面跟上行结束符字符串。

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void WriteLine (string format, object arg0, object arg1);

override this.WriteLine : string * obj * obj -> unit

Public Overrides Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

参数

format

String

包含零个或多个格式项的字符串。

arg0

Object

要设置其格式的对象。

arg1

Object

要设置其格式的对象。

示例

下面的代码示例演示如何使用 WriteLine 方法呈现带格式的字符串以及 属性和 Today 属性的值CurrentCulture。

// Use the WriteLine(string,object,object) method to
// render a formatted string and two objects 
// in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.",
    CultureInfo.CurrentCulture, DateTime.Today);
writer.RenderEndTag();

' Use the WriteLine(string,object,object) method to
' render a formatted string and two objects 
' in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.", _
    CultureInfo.CurrentCulture, DateTime.Today)
writer.RenderEndTag()

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 方法 WriteLine 使用与 方法相同的语义 Format(String, Object, Object) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[], Int32, Int32)

将任何挂起的制表符间距和一个 Unicode 字符子数组写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(cli::array <char> ^ buffer, int index, int count);

public override void WriteLine (char[] buffer, int index, int count);

override this.WriteLine : char[] * int * int -> unit

Public Overrides Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

参数

buffer

Char[]

向输出流写入文本所使用的字符数组。

index

Int32

字符数组中开始写入的位置。

count

Int32

要写入到输出流的数组中的字符数。

示例

本部分包含两个代码示例。 第一个示例演示如何创建字符数组。 第二个示例演示如何使用 数组。

这些代码示例生成以下标记：

<label>

hello

</label>

下面的代码示例演示如何创建拼写的 hello world字符数组。 数组 SpaceChar 中包括 字段，该字段在两个单词之间创建一个空格。

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};

Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

下面的代码示例使用 index 方法的 WriteLine 和 count 参数来呈现在前面的代码示例中创建的数组的前五个字符。

// Render a subarray of a character array
// as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars, 0, 5);
writer.RenderEndTag();

' Render a subarray of a character array
' as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars, 0, 5)
writer.RenderEndTag()

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object[])

将任何挂起的制表符间距和一个包含对象数组的文本表示形式的格式化字符串写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void WriteLine (string format, params object[] arg);

override this.WriteLine : string * obj[] -> unit

Public Overrides Sub WriteLine (format As String, ParamArray arg As Object())

参数

format

String

包含零个或多个格式项的字符串。

arg

Object[]

要格式化的对象数组。

示例

本部分包含两个代码示例。 第一个示例演示如何将字符串和数组呈现到输出流。 第二个演示如何声明数组。

下面的代码示例演示如何使用 WriteLine 方法将格式化字符串和对象数组的内容呈现到输出流。

// Render a formatted string and the
// text representation of an object array,
// myObjectArray, as the contents of
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime);
writer.RenderEndTag();

' Render a formatted string and the
' text representation of an object array,
' myObjectArray, as the contents of
' a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

下面的代码示例演示如何声明在前面的代码示例中呈现的对象数组。

private object[] curPriceTime = {4.25, DateTime.Now};

Private curPriceTime() As Object = {4.25, DateTime.Now}

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 方法 WriteLine 使用与 方法相同的语义 Format(String, Object[]) 。 基 WriteLine 方法用于编写 value 方法。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object)

将任何挂起的制表符间距和一个包含一个对象的文本表示形式的格式化字符串写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0);

public override void WriteLine (string format, object arg0);

override this.WriteLine : string * obj -> unit

Public Overrides Sub WriteLine (format As String, arg0 As Object)

参数

format

String

包含零个或多个格式项的字符串。

arg0

Object

要设置其格式的对象。

示例

下面的代码示例演示如何使用 WriteLine 方法以 属性的值呈现带格式的 CurrentCulture 字符串。

// Use the WriteLine(string, object) method to
// render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}",
    CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the WriteLine(string, object) method to
' render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}.", _
    CultureInfo.CurrentCulture)
writer.RenderEndTag()

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 方法 WriteLine 使用与 方法相同的语义 Format(String, Object) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(UInt32)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案

System.Web.UI.HtmlTextWriter.WriteLine(Int64)

将任何挂起的制表符间距和一个 4 字节无符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(System::UInt32 value);

[System.CLSCompliant(false)]
public override void WriteLine (uint value);

[<System.CLSCompliant(false)>]
override this.WriteLine : uint32 -> unit

Public Overrides Sub WriteLine (value As UInteger)

参数

value

UInt32

要写入到输出流的 4 字节无符号整数。

属性

CLSCompliantAttribute

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(String)

将任何挂起的制表符间距和一个文本字符串写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(System::String ^ s);

public override void WriteLine (string s);

override this.WriteLine : string -> unit

Public Overrides Sub WriteLine (s As String)

参数

s

String

要写入到输出流的字符串。

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Single)

将任何挂起的制表符间距和一个单精度浮点数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(float value);

public override void WriteLine (float value);

override this.WriteLine : single -> unit

Public Overrides Sub WriteLine (value As Single)

参数

value

Single

要写入到输出流的单精度浮点数。

示例

下面的代码示例演示如何使用 WriteLine 方法呈现 字段的值 Single.Epsilon ，这是 结构的最小可能值 Single 。

此代码示例生成以下标记：

<b>

1.401298E-45

</b>

// Use the WriteLine(Single) method to render the
// Epsilon field of the Single structure.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(Single.Epsilon);
writer.RenderEndTag();

' Use the WriteLine(Single) method to render the
' Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(Single.Epsilon)
writer.RenderEndTag()

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Int32)

将任何挂起的制表符间距和一个 32 字节有符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(int value);

public override void WriteLine (int value);

override this.WriteLine : int -> unit

Public Overrides Sub WriteLine (value As Integer)

参数

value

Int32

要写入到输出流的 32 字节的带符号整数。

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Int64)

将任何挂起的制表符间距和一个 64 字节有符号整数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(long value);

public override void WriteLine (long value);

override this.WriteLine : int64 -> unit

Public Overrides Sub WriteLine (value As Long)

参数

value

Int64

要写入到输出流的 64 字节的带符号整数。

注解

默认行终止符字符串是后跟 (“\r\n”) 的换行符。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Double)

将任何挂起的制表符间距和一个双精度浮点数的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(double value);

public override void WriteLine (double value);

override this.WriteLine : double -> unit

Public Overrides Sub WriteLine (value As Double)

参数

value

Double

要写入到输出流的双精度浮点数。

示例

下面的代码示例演示如何使用 WriteLine 方法呈现 字段的值 Double.MaxValue 。

此代码示例生成以下标记：

<label>

1.79769313486232E+308

</label>

// Use the WriteLine(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(Double.MaxValue);
writer.RenderEndTag();

' Use the WriteLine(Double) method to render
' the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(Double.MaxValue)
writer.RenderEndTag()

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[])

将任何挂起的制表符间距和一个 Unicode 字符数组写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(cli::array <char> ^ buffer);

public override void WriteLine (char[] buffer);

override this.WriteLine : char[] -> unit

Public Overrides Sub WriteLine (buffer As Char())

参数

buffer

Char[]

要写入到输出流的字符数组。

示例

本部分提供两个代码示例。 第一个示例演示如何创建数组。 第二个示例演示如何使用该数组。

这些代码示例生成以下标记：

<label>

hello world

</label>

下面的代码示例演示如何创建拼写的 hello world字符数组。 数组 SpaceChar 中包括 字段，该字段在两个单词之间创建一个空格。

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};

Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

下面的代码示例使用 WriteLine 方法呈现hello world在前面的示例中创建的字符数组。

// Render a character array as the contents of 
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars);
writer.RenderEndTag();

' Render a character array as the 
' contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars)
writer.RenderEndTag()

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Char)

将任何挂起的制表符间距和一个 Unicode 字符写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(char value);

public override void WriteLine (char value);

override this.WriteLine : char -> unit

Public Overrides Sub WriteLine (value As Char)

参数

value

Char

要写入到输出流的字符。

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Boolean)

将任何挂起的制表符间距和一个布尔值的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(bool value);

public override void WriteLine (bool value);

override this.WriteLine : bool -> unit

Public Overrides Sub WriteLine (value As Boolean)

参数

value

Boolean

要写入到输出流的布尔值。

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine()

将行结束符字符串写入到输出流。

public:
 override void WriteLine();

public override void WriteLine ();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

示例

下面的代码示例演示如何使用 WriteLine 方法在呈现元素后 <img> 插入行。

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 有关详细信息，请参阅 WriteLine。

另请参阅

• NewLine
• TextWriter
• WriteLine

WriteLine(Object)

将任何挂起的制表符间距和一个对象的文本表示形式写入到输出流，并在后面跟上一个行结束符字符串。

public:
 override void WriteLine(System::Object ^ value);

public override void WriteLine (object value);

override this.WriteLine : obj -> unit

Public Overrides Sub WriteLine (value As Object)

参数

value

Object

要写入到输出流的对象。

示例

下面的代码示例演示如何使用 WriteLine 方法将 属性的值 CultureInfo.CurrentCulture 呈现给控件。

// Use the WriteLine method to render an arbitrary
// object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the WriteLine method to render an arbitrary
' object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(CultureInfo.CurrentCulture)
writer.RenderEndTag()

注解

默认行终止符字符串是回车符，后跟换行符 (“\r\n”) 。 基 WriteLine 方法用于写入 value 参数。

另请参阅

• NewLine
• TextWriter
• WriteLine