HtmlTextWriter.RenderBeginTag 方法

  • 參考

定義

命名空間:
System.Web.UI
組件:
System.Web.dll

將標記項目的開頭標記寫入輸出資料流中。

多載

RenderBeginTag(String)

將指定標記項目的開頭標記寫入到輸出資料流。
RenderBeginTag(HtmlTextWriterTag)

將與指定的 HtmlTextWriterTag 列舉值相關聯的標記項目的開頭標記寫入輸出資料流中。

RenderBeginTag(String)

將指定標記項目的開頭標記寫入到輸出資料流。

public:
 virtual void RenderBeginTag(System::String ^ tagName);
public virtual void RenderBeginTag (string tagName);
abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unit
Public Overridable Sub RenderBeginTag (tagName As String)

參數

tagName
String

字串，包含要轉譯開頭標記之標記項目的名稱。

範例

下列程式碼範例示範如何在自訂控制項中呼叫 RenderBeginTag 方法，以轉譯非標準 MyTag 專案的開頭標記。 程式碼範例接著會 Write 呼叫 方法來轉譯內部標記，然後呼叫 RenderEndTag 方法以關閉 專案。

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

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

備註

RenderBeginTag如果標記專案不是其中 HtmlTextWriterTag 一個列舉值，請使用 方法的 RenderBeginTag(String) 覆寫。

若要使用 RenderBeginTag 方法產生標記專案，請先視需要呼叫 AddAttribute 和 AddStyleAttribute 方法，以指定要出現在專案開頭標記中的任何專案屬性或樣式屬性。 產生內部標記之後，請呼叫 RenderEndTag 方法來產生結束記號。

另請參閱

適用於

RenderBeginTag(HtmlTextWriterTag)

將與指定的 HtmlTextWriterTag 列舉值相關聯的標記項目的開頭標記寫入輸出資料流中。

public:
 virtual void RenderBeginTag(System::Web::UI::HtmlTextWriterTag tagKey);
public virtual void RenderBeginTag (System.Web.UI.HtmlTextWriterTag tagKey);
abstract member RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
override this.RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
Public Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)

參數

tagKey
HtmlTextWriterTag

其中一個 HtmlTextWriterTag 值，定義要呈現的標記項目的開頭標記。

範例

下列程式碼範例示範如何使用 RenderBeginTag 方法來輸出專案的開頭標記 <img> 。 由 AddAttribute 方法新增至元素的屬性將會位於開頭 <img> 標記中。 方法 RenderEndTag 可用來產生結束記號。

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

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

</img>

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

備註

RenderBeginTag如果標記專案屬於屬於其中一個列舉值的已知型別， HtmlTextWriterTag 請使用 方法的多載 RenderBeginTag(HtmlTextWriterTag) 。

若要使用 RenderBeginTag 方法產生標記專案，請先視需要呼叫 AddAttribute 和 AddStyleAttribute 方法，以指定要出現在專案開頭標記中的任何專案屬性或樣式屬性。 產生內部標記之後，請呼叫 RenderEndTag 方法來產生結束記號。

另請參閱

適用於