HtmlTextWriter.WriteAttribute 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將標記屬性和屬性值寫入輸出資料流中。

多載

WriteAttribute(String, String, Boolean)	將指定的標記屬性和值寫入輸出資料流，並在指定時寫入編碼值。
WriteAttribute(String, String)	將指定的標記屬性和值寫入輸出資料流中。

WriteAttribute(String, String, Boolean)

將指定的標記屬性和值寫入輸出資料流，並在指定時寫入編碼值。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);

public virtual void WriteAttribute (string name, string value, bool fEncode);

abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit

Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

參數

name

String

寫入輸出資料流的標記屬性。

value

String

指派給屬性的值。

fEncode

Boolean

true 表示要編碼屬性及其指派的值；否則為 false。

範例

下列程式碼範例示範如何轉譯呼叫 方法的 WriteAttribute 兩個 <img> 多載的專案。 程式碼範例會使用下列程式：

• WriteBeginTag呼叫 方法，這個方法會轉譯專案的開頭字元。

• 呼叫 多 WriteAttribute(String, String) 載，這個多載會將 alt 屬性及其值 <img> 寫入專案。

• 呼叫 多 WriteAttribute(String, String, Boolean) 載以轉譯具有 值 No "encoding" required 的自訂 myattribute 屬性，然後將 設定 fEncode 為 false 。

• 關閉專案的開頭標記，然後呼叫 WriteEndTag 方法來關閉 <img> 專案。

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

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

備註

WriteAttribute使用 方法來撰寫標記屬性及其值，以及其具有或不含編碼方式。 方法 WriteAttribute 會 HtmlAttributeEncode 使用 方法來執行編碼。

方法 WriteAttribute 會寫入以雙引號括住的屬性值， (「) 。 如果 為 valuenull ，方法 WriteAttribute 只會寫入屬性名稱。

給繼承者的注意事項

在衍生類別中，您可以覆寫 WriteAttribute(String, String, Boolean) 方法來定義撰寫屬性及其值的自訂規則。 例如，您可以撰寫程式碼，以允許 WriteAttribute(String, String, Boolean) 方法以空值撰寫屬性。

另請參閱

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

將指定的標記屬性和值寫入輸出資料流中。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);

public virtual void WriteAttribute (string name, string value);

abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit

Public Overridable Sub WriteAttribute (name As String, value As String)

參數

name

String

要寫入輸出資料流中的屬性。

value

String

指派給屬性的值。

範例

下列程式碼範例示範如何轉譯呼叫 方法的 WriteAttribute 兩個 <img> 多載的專案。 程式碼範例會使用下列程式：

• WriteBeginTag呼叫 方法，這個方法會轉譯專案的開頭字元。

• 呼叫 多 WriteAttribute(String, String) 載，這個多載會將 alt 屬性及其值 <img> 寫入專案。

• 呼叫 多 WriteAttribute(String, String, Boolean) 載以轉譯具有 值 No "encoding" required 的自訂 myattribute 屬性，然後將 設定 fEncode 為 false 。

• 關閉專案的開頭標記，然後呼叫 WriteEndTag 方法來關閉 <img> 專案。

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

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

備註

WriteAttribute使用 方法來撰寫標記屬性及其值，而不使用編碼方式。 方法 WriteAttribute 會寫入以雙引號括住的屬性值， (「) 。 如果 為 valuenull ，方法 WriteAttribute 只會寫入屬性名稱。

給繼承者的注意事項

在衍生類別中，您可以覆寫 WriteAttribute(String, String) 方法來定義撰寫屬性及其值的自訂規則。 例如，您可以撰寫程式碼，以允許 WriteAttribute(String, String) 方法以空值撰寫屬性。

另請參閱

• TextWriter