HtmlTextWriter.WriteAttribute メソッド (String, String, Boolean)

指定した HTML 属性と値を HtmlTextWriter 出力ストリームに書き込み、 fEncode パラメータで指定した場合はそれらの属性と値を HTML エンコードします。

Overloads Public Overridable Sub WriteAttribute( _
   ByVal name As String, _   ByVal value As String, _   ByVal fEncode As Boolean _)
[C#]
public virtual void WriteAttribute(stringname,stringvalue,boolfEncode);
[C++]
public: virtual void WriteAttribute(String* name,String* value,boolfEncode);
[JScript]
public function WriteAttribute(
   name : String,value : String,fEncode : Boolean);

パラメータ

• name
  出力ストリームに書き込む HTML 属性。
• value
  HTML 属性に代入される値。
• fEncode
  属性と代入された値を HTML エンコードする場合は true 。それ以外の場合は false 。

解説

AddAttribute メソッドや RenderBeginTag メソッドへの呼び出しとは異なり、 WriteAttribute を呼び出してもブラウザ情報に基づくマップは行われません。HTML サーバー コントロールは、このメソッドを呼び出してその属性を表示します。コントロールのグループが属性を表示する方法は変更できません。

使用例

[Visual Basic, C#, C++] WriteAttribute メソッドの両方のバージョンを使用する例を次に示します。最初のバージョンでは alt 属性を Img 要素に書き込み、2 つ目のバージョンでは、 No "encoding" required の値と共にカスタムの myattribute 属性を書き込み、 fEncode パラメータを false に設定します。

 
' 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")
writer.WriteLine()

writer.Indent -= 1
writer.RenderEndTag()

[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");
writer.WriteLine();

writer.Indent--;
writer.RenderEndTag();

[C++] 
// Create a manually rendered tag.
writer->WriteBeginTag(S"img");
writer->WriteAttribute(S"alt", S"AtlValue");
writer->WriteAttribute(S"myattribute", S"No "encoding " required", false);
writer->Write(HtmlTextWriter::TagRightChar);
writer->WriteEndTag(S"img");
writer->WriteLine();

writer->Indent--;
writer->RenderEndTag();

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

HtmlTextWriter クラス | HtmlTextWriter メンバ | System.Web.UI 名前空間 | HtmlTextWriter.WriteAttribute オーバーロードの一覧