共用方式為


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 方法來結束元素的 <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 基底方法。

另請參閱

適用於

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

另請參閱

適用於

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

另請參閱

適用於