HtmlTextWriter.WriteBeginTag(String) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將指定標記項目的任何定位間距和開頭標記，寫入至輸出資料流中。

public:
 virtual void WriteBeginTag(System::String ^ tagName);

public virtual void WriteBeginTag (string tagName);

abstract member WriteBeginTag : string -> unit
override this.WriteBeginTag : string -> unit

Public Overridable Sub WriteBeginTag (tagName As String)

參數

tagName

String

要寫入其開頭標記的標記項目。

範例

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

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

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

• 呼叫 多 WriteAttribute(String, String, Boolean) 載來轉譯自訂 myattribute 屬性，其值為 No "encoding" required ，然後將 設定 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)

備註

方法 WriteBeginTag 不會將右角括弧寫入標記專案的開頭標記 (>) 。 這允許將標記屬性寫入元素的開頭標記。 呼叫 方法時 WriteBeginTag ， TagRightChar 請使用 常數來關閉開頭標記。 WriteBeginTag當您撰寫自我關閉的標記專案時， SelfClosingTagEnd 請使用 方法搭配常數。

方法 WriteBeginTag 是由自訂伺服器控制項使用，這些控制項不允許標記或屬性對應，並以相同方式呈現每個要求的標記專案。

另請參閱

• TextWriter
• WriteAttribute
• TagRightChar
• SelfClosingTagEnd
• WriteEndTag(String)