HtmlTextWriter.Write 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將指定資料型別以及任何暫止定位空格寫入輸出資料流。

多載

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)

將布林值的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (bool value);

參數

value

Boolean

要寫入輸出資料流中的 Boolean。

備註

方法 Write 會產生任何擱置的索引標籤，然後呼叫 Write 基底方法。

另請參閱

• TextWriter

Write(Char)

將 Unicode 字元的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (char value);

參數

value

Char

要寫入輸出資料流中的 Unicode 字元。

範例

下列程式碼範例示範如何使用 Write 方法來結束元素的 <img> 開頭標記，方法是使用 TagRightChar 常數。

此程式碼範例會轉譯下列標記：

<img alt="A custom image">

</img>

C#

// 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 字元陣列的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (char[] buffer);

參數

buffer

Char[]

要寫入輸出資料流中的 Unicode 字元陣列。

範例

本節提供兩個程式碼範例。 第一個示範如何建立字元陣列。 第二個示範如何使用 陣列。

這些程式碼範例會產生下列標記：

<label>

hello world

</label>

下列程式碼範例示範如何建立拼字的 hello world 字元陣列。 陣列中包含 欄位 SpaceChar ，這會在兩個單字之間建立空格。

C#

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

下列程式碼範例示範如何使用 Write 方法，將上述程式碼範例中建立的字元陣列轉 hello world 譯為頁面，當包含此範例程式碼的控制項包含在頁面中時。

C#

// 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)

將雙精度浮點數的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (double value);

參數

value

Double

要寫入輸出資料流中的雙精度浮點數。

範例

下列程式碼範例示範如何使用 Write 方法來呈現域的值 Double.MaxValue 。

此程式碼範例會產生下列標記：

<label>

1.79769313486232E+308

</label>

C#

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

備註

方法 Write 會產生任何擱置的索引標籤，然後呼叫 Write 基底方法。

另請參閱

• TextWriter

Write(Int32)

將 32 位元組帶正負數的整數之文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (int value);

參數

value

Int32

要寫入至輸出資料流的 32 位元組帶正負號的整數。

備註

方法 Write 會產生任何擱置的索引標籤，然後呼叫 Write 基底方法。

另請參閱

• TextWriter

Write(Int64)

將 64 位元組帶正負數的整數之文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (long value);

參數

value

Int64

要寫入至輸出資料流的 64 位元組帶正負號的整數。

備註

方法 Write 會產生任何擱置的索引標籤，然後呼叫 Write 基底方法。

另請參閱

• TextWriter

Write(Object)

將物件的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (object value);

參數

value

Object

要寫入輸出資料流中的物件。

範例

下列程式碼範例示範如何使用 Write 方法呈現 屬性的值 CultureInfo.CurrentCulture 。

此程式碼範例會產生下列標記：

This is a rendered CultureInfo object.

<bold>

屬性的值 CurrentCulture ：

</bold>

C#

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

另請參閱

• TextWriter
• CurrentCulture

Write(Single)

將單精確度浮點數的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (float value);

參數

value

Single

要寫入輸出資料流中的單精確度浮點數。

範例

下列程式碼範例示範如何使用 Write 方法來呈現 欄位的值 Single.Epsilon ，這是 結構的最小可能值 Single 。

此程式碼範例會產生下列標記：

<b>

1.401298E-45

</b>

C#

// 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)

將指定字串以及任何暫止定位空格寫入輸出資料流。

C#

public override void Write (string s);

參數

s

String

要寫入輸出資料流的字串。

範例

下列程式碼範例示範如何使用 Write 方法，在自訂標記專案的開頭和結束記號之間轉譯字串。

此程式碼範例會產生下列標記：

<MyTag>

Contents of MyTag

</MyTag>

C#

// 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) 方法相同的語意。

C#

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

參數

format

String

包含零或多個格式項目的字串。

arg0

Object

要格式化的物件。

範例

下列程式碼範例示範如何使用 Write 方法來轉譯具有 屬性值的 CurrentCulture 格式化字串。

C#

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

另請參閱

• TextWriter
• Format(String, Object)
• CurrentCulture

Write(String, Object[])

將格式化字串 (其中包含物件陣列的文字表示) 以及任何暫止定位空格寫入輸出資料流。 這個方法使用的語意與 Format(String, Object[]) 方法相同。

C#

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

參數

format

String

包含零或多個格式項目的字串。

arg

Object[]

要格式化的物件陣列。

範例

本節包含兩個程式碼範例。 第一個示範如何轉譯格式化字串和陣列的內容。 第二個示範如何宣告陣列。

下列程式碼範例示範如何使用 Write 方法來呈現格式化字串，以及名為 curPriceTime 的物件陣列內容。 方法呼叫會先轉譯陣列的第二個成員，再轉譯第一個成員。

C#

// 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 宣告物件陣列。

C#

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

備註

方法 Write 會產生任何擱置的索引標籤，然後呼叫 Write 基底方法。

另請參閱

• TextWriter
• Format(String, Object[])

Write(Char[], Int32, Int32)

將 Unicode 字元子陣列的文字表示以及任何暫止定位空格寫入輸出資料流。

C#

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

參數

buffer

Char[]

字元陣列，可從中將文字寫入輸出資料流。

index

Int32

陣列中開始寫入的索引位置。

count

Int32

要寫入輸出資料流中的字元數。

範例

本節提供兩個程式碼範例。 第一個示範如何建立字元陣列。 第二個示範如何使用 陣列。

這些程式碼範例會產生下列標記：

<label>

hello

</label>

下列程式碼範例示範如何建立拼字的 hello world 字元陣列。 陣列中包含 欄位 SpaceChar ，這會在兩個單字之間建立空格。

C#

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

下列程式碼範例部分會使用 index 方法的 Write 和 count 參數，轉譯在上述範例中建立之陣列的前五個字元。

C#

// 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) 方法相同。

C#

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

參數

format

String

包含零或多個格式項目的字串。

arg0

Object

要格式化的物件。

arg1

Object

要格式化的物件。

範例

下列程式碼範例示範如何使用 Write 方法來呈現格式化字串和 和 Today 屬性的值 CurrentCulture 。

C#

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

另請參閱

• TextWriter
• Format(String, Object, Object)
• CurrentCulture