HtmlTextWriter.Write 方法

参考

定义

命名空间:: System.Web.UI

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将指定数据类型和任何挂起的制表符间距一起写入到输出流。

重载

Write(Boolean)	将布尔值的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Char)	将 Unicode 字符的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Char[])	将 Unicode 字符数组的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Double)	将双精度浮点数的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Int32)	将 32 字节的带符号整数的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Int64)	将 64 字节的带符号整数的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Object)	将对象的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(Single)	将单精度浮点数的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(String)	将指定的字符串和任何挂起的制表符间距一起写入到输出流。
Write(String, Object)	使用与 Format(String, Object) 方法相同的语义，将一个制表符字符串和一个格式化字符串连同任何挂起的制表符间距一起写入到输出流。
Write(String, Object[])	将包含某对象数组的文本表示形式的格式化字符串和任何挂起的制表符间距一起写入到输出流。该方法使用与 Format(String, Object[]) 方法相同的语义。
Write(Char[], Int32, Int32)	将 Unicode 字符子数组的文本表示形式和任何挂起的制表符间距一起写入到输出流。
Write(String, Object, Object)	将包含两个对象的文本表示形式的格式化字符串和任何挂起的制表符间距一起写入到输出流。该方法使用与 Format(String, Object, Object) 方法相同的语义。

Write(Boolean)

将布尔值的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(bool value);

public override void Write (bool value);

override this.Write : bool -> unit

Public Overrides Sub Write (value As Boolean)

参数

value: Boolean

要写入到输出流的 Boolean。

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Char)

将 Unicode 字符的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

参数

value: Char

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

示例

下面的代码示例演示如何使用 Write 方法通过使用 TagRightChar 常量结束元素的<img>开始标记。

此代码示例呈现以下标记：

<img alt="A custom image">

</img>

// Create a manually rendered <img> element
// that contains an alt attribute.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "A custom image.");
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered <img> element
' that contains an alt attribute.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "A custom image.")
writer.Write(HtmlTextWriter.TagRightChar)
writer.WriteEndTag("img")

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Char[])

将 Unicode 字符数组的文本表示形式和任何挂起的制表符间距一起写入到输出流。

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

public override void Write (char[] buffer);

override this.Write : char[] -> unit

Public Overrides Sub Write (buffer As Char())

参数

buffer: Char[]

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

示例

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

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

<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}

下面的代码示例演示了当包含此示例代码的控件包含在页面中时，如何使用 Write 方法将前面代码示例中创建的字符数组呈现 hello world 到页面。

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

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Double)

将双精度浮点数的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(double value);

public override void Write (double value);

override this.Write : double -> unit

Public Overrides Sub Write (value As Double)

参数

value: Double

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

示例

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

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

<label>

1.79769313486232E+308

</label>

// Use the Write(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(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()

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Int32)

将 32 字节的带符号整数的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(int value);

public override void Write (int value);

override this.Write : int -> unit

Public Overrides Sub Write (value As Integer)

参数

value: Int32

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Int64)

将 64 字节的带符号整数的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(long value);

public override void Write (long value);

override this.Write : int64 -> unit

Public Overrides Sub Write (value As Long)

参数

value: Int64

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(Object)

将对象的文本表示形式和任何挂起的制表符间距一起写入到输出流。

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

public override void Write (object value);

override this.Write : obj -> unit

Public Overrides Sub Write (value As Object)

参数

value: Object

要写入到输出流的对象。

示例

下面的代码示例演示如何使用 Write 方法呈现属性的值 CultureInfo.CurrentCulture 。

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

This is a rendered CultureInfo object.

<bold>

属性的值 CurrentCulture ：

</bold>

// Use the Write method to render an arbitrary
// object, in this case a CultureInfo object. 
writer.Write("This is a rendered CultureInfo Object.");
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the Write method to render an arbitrary
' object, in this case a CultureInfo object.
writer.Write("This is a rendered CultureInfo Object.")
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(CultureInfo.CurrentCulture)
writer.RenderEndTag()

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

适用于

Write(Single)

将单精度浮点数的文本表示形式和任何挂起的制表符间距一起写入到输出流。

public:
 override void Write(float value);

public override void Write (float value);

override this.Write : single -> unit

Public Overrides Sub Write (value As Single)

参数

value: Single

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

示例

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

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

<b>

1.401298E-45

</b>

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

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(String)

将指定的字符串和任何挂起的制表符间距一起写入到输出流。

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

public override void Write (string s);

override this.Write : string -> unit

Public Overrides Sub Write (s As String)

参数

s: String

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

示例

下面的代码示例演示如何使用 Write 方法在自定义标记元素的开始标记和结束标记之间呈现字符串。

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

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();

// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();

' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(String, Object)

使用与 Format(String, Object) 方法相同的语义，将一个制表符字符串和一个格式化字符串连同任何挂起的制表符间距一起写入到输出流。

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

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

override this.Write : string * obj -> unit

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

参数

format: String

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

arg0: Object

要设置其格式的对象。

示例

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

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

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

适用于

Write(String, Object[])

将包含某对象数组的文本表示形式的格式化字符串和任何挂起的制表符间距一起写入到输出流。该方法使用与 Format(String, Object[]) 方法相同的语义。

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

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

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

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

参数

format: String

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

arg: Object[]

要格式化的对象数组。

示例

本部分包含两个代码示例。第一个示例演示如何呈现格式化字符串和数组的内容。第二个示例演示如何声明数组。

下面的代码示例演示如何使用 Write 方法呈现格式化字符串和名为 curPriceTime的对象数组的内容。方法调用在呈现第一个成员之前呈现数组的第二个成员。

// 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.Write("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.Write("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

下面的代码示例演示如何声明 curPriceTime 对象数组。

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

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

注解

方法 Write 生成任何挂起的选项卡，然后调用 Write 基方法。

另请参阅

适用于

Write(Char[], Int32, Int32)

将 Unicode 字符子数组的文本表示形式和任何挂起的制表符间距一起写入到输出流。

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

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

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

Public Overrides Sub Write (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 方法的 Write 和 count 参数呈现在上一示例中创建的数组的前五个字符。

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

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

注解

方法 Write 生成挂起的任何选项卡，然后调用 Write 基方法。

另请参阅

TextWriter

适用于

Write(String, Object, Object)

将包含两个对象的文本表示形式的格式化字符串和任何挂起的制表符间距一起写入到输出流。该方法使用与 Format(String, Object, Object) 方法相同的语义。

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

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

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

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

参数

format: String

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

arg0: Object

要设置其格式的对象。

arg1: Object

要设置其格式的对象。

示例

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

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

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

注解

方法 Write 生成挂起的任何选项卡，然后调用 Write 基方法。

另请参阅

适用于

通过

HtmlTextWriter.Write 方法

定义

重载

Write(Boolean)

参数

注解

另请参阅

适用于

Write(Char)

参数

示例

注解

另请参阅

适用于

Write(Char[])

参数

示例

注解

另请参阅

适用于

Write(Double)

参数

示例

注解

另请参阅

适用于

Write(Int32)

参数

注解

另请参阅

适用于

Write(Int64)

参数

注解

另请参阅

适用于

Write(Object)

参数

示例

注解

另请参阅

适用于

Write(Single)

参数

示例

注解

另请参阅

适用于

Write(String)

参数

示例

注解

另请参阅

适用于

Write(String, Object)

参数

示例

注解

另请参阅

适用于

Write(String, Object[])

参数

示例

注解

另请参阅

适用于

Write(Char[], Int32, Int32)

参数

示例

注解

另请参阅

适用于

Write(String, Object, Object)

参数

示例

注解

另请参阅

适用于

其他资源