HtmlTextWriter.RenderBeginTag メソッド

定義

マークアップ要素の開始タグを出力ストリームに書き込みます。Writes the opening tag of a markup element to the output stream.

オーバーロード

RenderBeginTag(String)

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

RenderBeginTag(HtmlTextWriterTag)

指定した HtmlTextWriterTag 列挙値に関連付けられたマークアップ要素の開始タグを出力ストリームに書き込みます。Writes the opening tag of the markup element associated with the specified HtmlTextWriterTag enumeration value to the output stream.

RenderBeginTag(String)

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

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

開始タグをレンダリングするマークアップ要素の名前を含む文字列。A string containing the name of the markup element for which to render the opening tag.

次のコード例は、 RenderBeginTag カスタムコントロールでメソッドを呼び出して、非標準の要素の開始タグを表示する方法を示して MyTag います。The following code example shows how to call the RenderBeginTag method in a custom control to render the opening tag of a non-standard MyTag element. このコード例では、 Write メソッドを呼び出して内部マークアップを表示し、メソッドを呼び出して RenderEndTag 要素を閉じます。The code example then calls the Write method to render inner markup, and then calls the RenderEndTag method to close the element.

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

<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 RenderBeginTag(String) マークアップ要素が列挙値のいずれでもない場合は、メソッドのオーバーライドを使用し HtmlTextWriterTag ます。Use the RenderBeginTag override of the RenderBeginTag(String) method, if the markup element is not one of the HtmlTextWriterTag enumeration values.

メソッドを使用してマークアップ要素を生成するには、まず、必要に応じ RenderBeginTag AddAttribute AddStyleAttribute てメソッドとメソッドを呼び出して、要素の開始タグに表示される要素属性またはスタイル属性を指定します。To generate a markup element by using the RenderBeginTag method, first call the AddAttribute and the AddStyleAttribute methods, as necessary, to specify any element attributes or style attributes that are to appear in the opening tag of the element. 内部マークアップを生成した後、メソッドを呼び出して RenderEndTag 終了タグを生成します。After generating the inner markup, call the RenderEndTag method to generate the closing tag.

こちらもご覧ください

適用対象

RenderBeginTag(HtmlTextWriterTag)

指定した HtmlTextWriterTag 列挙値に関連付けられたマークアップ要素の開始タグを出力ストリームに書き込みます。Writes the opening tag of the markup element associated with the specified HtmlTextWriterTag enumeration value to the output stream.

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 値の 1 つ。One of the HtmlTextWriterTag values that defines the opening tag of the markup element to render.

次のコード例は、メソッドを使用して、要素の開始タグを出力する方法を示して RenderBeginTag <img> います。The following code example shows how to use the RenderBeginTag method to output the opening tag of an <img> element. メソッドによって要素に追加される属性 AddAttribute は、開始タグに含まれ <img> ます。The attributes that are added to the element by the AddAttribute method will be in the opening <img> tag. メソッドは、 RenderEndTag 終了タグを生成するために使用されます。The RenderEndTag method is used to generate the closing tag.

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

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

注釈

RenderBeginTag RenderBeginTag(HtmlTextWriterTag) マークアップ要素が列挙値のいずれかである既知の型である場合は、メソッドのオーバーロードを使用し HtmlTextWriterTag ます。Use the RenderBeginTag overload of the RenderBeginTag(HtmlTextWriterTag) method if the markup element is of a known type that is one of the HtmlTextWriterTag enumeration values.

メソッドを使用してマークアップ要素を生成するには、まず、必要に応じ RenderBeginTag AddAttribute AddStyleAttribute てメソッドとメソッドを呼び出して、要素の開始タグに表示される要素属性またはスタイル属性を指定します。To generate a markup element by using the RenderBeginTag method, first call the AddAttribute and the AddStyleAttribute methods, as necessary, to specify any element attributes or style attributes that are to appear in the opening tag of the element. 内部マークアップを生成した後、メソッドを呼び出して RenderEndTag 終了タグを生成します。After generating the inner markup, call the RenderEndTag method to generate the closing tag.

こちらもご覧ください

適用対象