次の方法で共有


HtmlTextWriter.WriteAttribute メソッド

定義

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

オーバーロード

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) 書き込むことができるコードを記述できます。

こちらもご覧ください

適用対象

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) 書き込むことができるコードを記述できます。

こちらもご覧ください

適用対象