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 方法來結束元素的 <img> 開頭標記，方法是使用 TagRightChar 常數。

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

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

參數

範例

備註

另請參閱

適用於

其他資源