HtmlTextWriter.WriteLine 方法

定义

按照重载参数的指定,将数据写入到 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 参数。

另请参阅

适用于

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``count该方法的参数WriteLine来呈现在前面的代码示例中创建的数组的前五个字符。

// 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 参数。

另请参阅

适用于

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 方法。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 字节无符号整数。

属性

注解

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

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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 参数。

另请参阅

适用于

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

另请参阅

适用于

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 参数。

另请参阅

适用于