HtmlTextWriter.RenderBeginTag 方法

定义

将标记元素的开始标记写入到输出流。

重载

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 该方法生成标记元素,请根据需要调用 AddAttributeAddStyleAttribute 方法,以指定要在元素的开始标记中显示的任何元素属性或样式属性。 生成内部标记后,调用 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如果标记元素是作为枚举值之一的已知类型,请使用该方法的RenderBeginTag(HtmlTextWriterTag)HtmlTextWriterTag重载。

若要使用 RenderBeginTag 该方法生成标记元素,请根据需要调用 AddAttributeAddStyleAttribute 方法,以指定要在元素的开始标记中显示的任何元素属性或样式属性。 生成内部标记后,调用 RenderEndTag 该方法以生成结束标记。

另请参阅

适用于