HtmlTextWriter.Write 方法

定义

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

重载

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

另请参阅

适用于

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

另请参阅

适用于

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}

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

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

另请参阅

适用于

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

另请参阅

适用于

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

另请参阅

适用于

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

另请参阅

适用于

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

另请参阅

适用于

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

另请参阅

适用于

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

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

另请参阅

适用于

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

另请参阅

适用于