HtmlTextWriter.WriteAttribute メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

マークアップ属性とその値を出力ストリームに書き込みます。

オーバーロード

WriteAttribute(String, String, Boolean)	指定されたマークアップ属性と値を出力ストリームに書き込みます。また、指定されている場合は、エンコードされた値も書き込みます。
WriteAttribute(String, String)	指定したマークアップ属性と値を出力ストリームに書き込みます。

WriteAttribute(String, String, Boolean)

指定されたマークアップ属性と値を出力ストリームに書き込みます。また、指定されている場合は、エンコードされた値も書き込みます。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);

public virtual void WriteAttribute (string name, string value, bool fEncode);

abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit

Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

パラメーター

name

String

出力ストリームに書き込むマークアップ属性。

value

String

属性に代入する値。

fEncode

Boolean

属性とその代入値をエンコードする場合は true、それ以外の場合は false。

例

次のコード例は、 メソッドの両方のオーバーロードが呼び出される要素のレンダリング <img> を WriteAttribute 示しています。 このコード例では、次のプロセスを使用します。

• 要素の WriteBeginTag 開始文字をレンダリングする メソッドを呼び出します。

• オーバーロードをWriteAttribute(String, String)呼び出します。これにより、属性とその値が <img> 要素に書き込altまれます。

• オーバーロードをWriteAttribute(String, String, Boolean)呼び出して、値 No "encoding" requiredが のカスタムmyattribute属性をレンダリングし、 を にfalse設定fEncodeします。

• 要素の開始タグを閉じ、 メソッドを 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 );
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)

注釈

エンコードの WriteAttribute 有無にかかわらず、マークアップ属性とその値を書き込むには、 メソッドを使用します。 メソッドは WriteAttribute 、 メソッドを HtmlAttributeEncode 使用してエンコードを行います。

メソッドは WriteAttribute 、二重引用符 (") で囲まれた属性値を書き込みます。 が nullの場合value、メソッドはWriteAttribute属性名のみを書き込みます。

注意 (継承者)

派生クラスでは、 メソッドを WriteAttribute(String, String, Boolean) オーバーライドして、属性とその値を書き込むカスタム 規則を定義できます。 たとえば、空の値を持つ属性をメソッドが WriteAttribute(String, String, Boolean) 書き込むことができるコードを記述できます。

こちらもご覧ください

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

指定したマークアップ属性と値を出力ストリームに書き込みます。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);

public virtual void WriteAttribute (string name, string value);

abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit

Public Overridable Sub WriteAttribute (name As String, value As String)

パラメーター

name

String

出力ストリームに書き込む属性。

value

String

属性に代入する値。

例

次のコード例は、 メソッドの両方のオーバーロードが呼び出される要素のレンダリング <img> を WriteAttribute 示しています。 このコード例では、次のプロセスを使用します。

• 要素の WriteBeginTag 開始文字をレンダリングする メソッドを呼び出します。

• オーバーロードをWriteAttribute(String, String)呼び出します。これにより、属性とその値が <img> 要素に書き込altまれます。

• オーバーロードをWriteAttribute(String, String, Boolean)呼び出して、値 No "encoding" requiredが のカスタムmyattribute属性をレンダリングし、 を にfalse設定fEncodeします。

• 要素の開始タグを閉じ、 メソッドを 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 );
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)

注釈

WriteAttributeマークアップ属性とその値をエンコードなしで書き込むには、 メソッドを使用します。 メソッドは WriteAttribute 、二重引用符 (") で囲まれた属性値を書き込みます。 が nullの場合value、メソッドはWriteAttribute属性名のみを書き込みます。

注意 (継承者)

派生クラスでは、 メソッドを WriteAttribute(String, String) オーバーライドして、属性とその値を書き込むカスタム 規則を定義できます。 たとえば、空の値を持つ属性をメソッドが WriteAttribute(String, String) 書き込むことができるコードを記述できます。

こちらもご覧ください

• TextWriter