共用方式為


HtmlTextWriter.WriteAttribute 方法

定義

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

多載

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> 多載的專案。 程式碼範例會使用下列程式:

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

<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使用 方法來撰寫標記屬性及其值,以及其具有或不含編碼方式。 方法 WriteAttributeHtmlAttributeEncode 使用 方法來執行編碼。

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

給繼承者的注意事項

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

另請參閱

適用於

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> 多載的專案。 程式碼範例會使用下列程式:

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

<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) 方法以空值撰寫屬性。

另請參閱

適用於