HtmlTextWriter.WriteAttribute メソッド

定義

マークアップ属性とその値を出力ストリームに書き込みます。Writes a markup attribute and its value to the output stream.

オーバーロード

WriteAttribute(String, String, Boolean)

指定されたマークアップ属性と値を出力ストリームに書き込みます。また、指定されている場合は、エンコードされた値も書き込みます。Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

WriteAttribute(String, String)

指定したマークアップ属性と値を出力ストリームに書き込みます。Writes the specified markup attribute and value to the output stream.

WriteAttribute(String, String, Boolean)

指定されたマークアップ属性と値を出力ストリームに書き込みます。また、指定されている場合は、エンコードされた値も書き込みます。Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

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

出力ストリームに書き込むマークアップ属性。The markup attribute to write to the output stream.

value
String

属性に代入する値。The value assigned to the attribute.

fEncode
Boolean

属性とその代入値をエンコードする場合は true、それ以外の場合は falsetrue to encode the attribute and its assigned value; otherwise, false.

次のコード例は、 <img> メソッドの両方のオーバーロードが呼び出される要素をレンダリングする方法を示して WriteAttribute います。The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. このコード例では、次のプロセスを使用します。The code example uses the following process:

  • WriteBeginTagメソッドを呼び出します。このメソッドは、要素の開始文字をレンダリングします。Calls the WriteBeginTag method, which renders the opening characters of the element.

  • WriteAttribute(String, String) alt 属性とその値を要素に書き込むオーバーロードを呼び出します <img>Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • オーバーロードを呼び出して、 WriteAttribute(String, String, Boolean) myattribute の値を持つカスタム属性をレンダリング No "encoding" required し、 fEncode をに設定し false ます。Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • 要素の開始タグを閉じ、メソッドを呼び出して WriteEndTag 要素を閉じ <img> ます。Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

このコード例では、次のマークアップが生成されます。This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

注釈

メソッドを使用して、 WriteAttribute エンコーディングの有無にかかわらずマークアップ属性とその値を書き込みます。Use the WriteAttribute method to write markup attributes and their values with or without encoding. メソッドは、メソッドを使用して WriteAttribute HtmlAttributeEncode エンコーディングを実行します。The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

メソッドは、 WriteAttribute 二重引用符 (") で囲まれた属性値を書き込みます。The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). がの場合 value nullWriteAttribute メソッドは属性名だけを書き込みます。If value is null, the WriteAttribute method writes only the attribute name.

注意 (継承者)

派生クラスでは、メソッドをオーバーライドして、 WriteAttribute(String, String, Boolean) 属性とその値を書き込むためのカスタム規則を定義できます。In derived classes, you can override the WriteAttribute(String, String, Boolean) method to define custom rules for writing attributes and their values. たとえば、 WriteAttribute(String, String, Boolean) 空の値を持つ属性を書き込むメソッドを許可するコードを記述できます。For example, you could write code that allowed the WriteAttribute(String, String, Boolean) method to write an attribute with an empty value.

こちらもご覧ください

適用対象

WriteAttribute(String, String)

指定したマークアップ属性と値を出力ストリームに書き込みます。Writes the specified markup attribute and value to the output stream.

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

出力ストリームに書き込む属性。The attribute to write to the output stream.

value
String

属性に代入する値。The value assigned to the attribute.

次のコード例は、 <img> メソッドの両方のオーバーロードが呼び出される要素をレンダリングする方法を示して WriteAttribute います。The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. このコード例では、次のプロセスを使用します。The code example uses the following process:

  • WriteBeginTagメソッドを呼び出します。このメソッドは、要素の開始文字をレンダリングします。Calls the WriteBeginTag method, which renders the opening characters of the element.

  • WriteAttribute(String, String) alt 属性とその値を要素に書き込むオーバーロードを呼び出します <img>Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • オーバーロードを呼び出して、 WriteAttribute(String, String, Boolean) myattribute の値を持つカスタム属性をレンダリング No "encoding" required し、 fEncode をに設定し false ます。Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • 要素の開始タグを閉じ、メソッドを呼び出して WriteEndTag 要素を閉じ <img> ます。Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

このコード例では、次のマークアップが生成されます。This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

注釈

WriteAttributeエンコードせずにマークアップ属性とその値を書き込むには、メソッドを使用します。Use the WriteAttribute method to write markup attributes and their values with no encoding. メソッドは、 WriteAttribute 二重引用符 (") で囲まれた属性値を書き込みます。The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). がの場合 value nullWriteAttribute メソッドは属性名だけを書き込みます。If value is null, the WriteAttribute method writes only the attribute name.

注意 (継承者)

派生クラスでは、メソッドをオーバーライドして、 WriteAttribute(String, String) 属性とその値を書き込むためのカスタム規則を定義できます。In derived classes, you can override the WriteAttribute(String, String) method to define custom rules for writing attributes and their values. たとえば、 WriteAttribute(String, String) 空の値を持つ属性を書き込むメソッドを許可するコードを記述できます。For example, you could write code that allowed the WriteAttribute(String, String) method to write an attribute with an empty value.

こちらもご覧ください

適用対象