HtmlTextWriter.WriteBeginTag(String) メソッド

定義

タブ空白文字と指定したマークアップ要素の開始タグを出力ストリームに書き込みます。Writes any tab spacing and the opening tag of the specified markup element to the output stream.

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

開始タグを書き込むマークアップ要素。The markup element of which to write the opening tag.

次のコード例は、 <img> WriteAttributeメソッドの両方のオーバーロードが呼び出される要素をレンダリングする方法を示しています。The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. このコード例では、次のプロセスを使用します。The code example uses the following process:

  • WriteBeginTagメソッドを呼び出します。このメソッドは、要素の開始文字をレンダリングします。Calls the WriteBeginTag method, which renders the opening characters of the element.

  • 属性とその値をWriteAttribute(String, String) 要素に書き込むオーバーロード<img>を呼び出します。 altCalls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • No "encoding" required myattribute falseオーバーロードを呼び出して、の値を持つカスタム属性をレンダリングし、をにfEncode設定します。 WriteAttribute(String, String, Boolean)Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • 要素の開始タグを閉じ、メソッドをWriteEndTag呼び出して<img>要素を閉じます。Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

このコード例では、次のマークアップが生成されます。This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

注釈

メソッドWriteBeginTagは、マークアップ要素の開始タグの終わり山かっこ (>) を書き込みません。The WriteBeginTag method does not write the closing angle bracket (>) of the markup element's opening tag. これにより、要素の開始タグにマークアップ属性を書き込むことができます。This allows the writing of markup attributes to the opening tag of the element. メソッドWriteBeginTagTagRightChar呼び出すときに、定数を使用して開始タグを閉じます。Use the TagRightChar constant to close the opening tag when calling the WriteBeginTag method. 自己終了WriteBeginTagするマークアップSelfClosingTagEnd要素を記述する場合は、メソッドを定数と共に使用します。Use the WriteBeginTag method with the SelfClosingTagEnd constant when you write markup elements that are self-closing.

メソッドWriteBeginTagは、タグまたは属性のマッピングを許可せず、マークアップ要素を各要求に対して同じ方法で表示しないカスタムサーバーコントロールによって使用されます。The WriteBeginTag method is used by custom server controls that do not allow tag or attribute mapping and render markup elements in the same way for each request.

適用対象

こちらもご覧ください