HtmlTextWriter.WriteBeginTag メソッド

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

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

構文

'宣言
Public Overridable Sub WriteBeginTag ( _
    tagName As String _
)
'使用
Dim instance As HtmlTextWriter
Dim tagName As String

instance.WriteBeginTag(tagName)

public virtual void WriteBeginTag (
    string tagName
)

public:
virtual void WriteBeginTag (
    String^ tagName
)

public void WriteBeginTag (
    String tagName
)

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>

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

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

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

// 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 Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

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