HtmlTextWriter.WriteBeginTag メソッド

.NET Framework クラス ライブラリ リファレンス

HtmlTextWriter.WriteBeginTag メソッド

タブ空白文字と指定したマークアップ要素の開始タグを出力ストリームに書き込みます。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub WriteBeginTag
 ( _
    tagName As String _
)

Visual Basic (使用法)

Dim instance As HtmlTextWriter
Dim tagName As String

instance.WriteBeginTag(tagName)

C#

public virtual void WriteBeginTag (
    string tagName
)

C++

public:
virtual void WriteBeginTag (
    String^ tagName
)

J#

public void WriteBeginTag (
    String tagName
)

JScript

public function WriteBeginTag (
    tagName : String
)

パラメータ

tagName

開始タグを書き込むマークアップ要素。

解説

WriteBeginTag メソッドは、マークアップ要素の開始タグの右山かっこ (>) を書き込みません。このため、マークアップ属性は要素の開始タグに書き込まれます。TagRightChar 定数を使用して、WriteBeginTag メソッドを呼び出すときに開始タグを閉じます。自己終了するマークアップ要素を書き込むときに、SelfClosingTagEnd 定数を使用する WriteBeginTag メソッドを使用します。

WriteBeginTag メソッドは、タグまたは属性の関連付けが許可されないカスタム サーバー コントロールで使用し、要求ごとに同じ方法でマークアップ要素を出力します。

使用例

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

Visual Basic

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No
 "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

C#

// 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");

C++

// 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" );

J#

// 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");

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HtmlTextWriter クラス
HtmlTextWriter メンバ
System.Web.UI 名前空間
TextWriter
WriteAttribute
TagRightChar
SelfClosingTagEnd
WriteEndTag