HtmlTextWriter.WriteAttribute メソッド

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)

パラメーター

例

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

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

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

• WriteAttribute(String, String, Boolean)オーバーロードを呼び出して、No "encoding" requiredの値を持つカスタム myattribute属性をレンダリングし、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 );
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 メソッドは、二重引用符 (") で囲まれた属性値を書き込みます。 valueがnullの場合、WriteAttribute メソッドは属性名のみを書き込みます。

注意 (継承者)

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

こちらもご覧ください

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

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)

パラメーター

例

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

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

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

• WriteAttribute(String, String, Boolean)オーバーロードを呼び出して、No "encoding" requiredの値を持つカスタム myattribute属性をレンダリングし、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 );
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 メソッドは、二重引用符 (") で囲まれた属性値を書き込みます。 valueがnullの場合、WriteAttribute メソッドは属性名のみを書き込みます。

注意 (継承者)

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

こちらもご覧ください

• TextWriter