HtmlTextWriter.WriteAttribute HtmlTextWriter.WriteAttribute HtmlTextWriter.WriteAttribute HtmlTextWriter.WriteAttribute Method

定義

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

オーバーロード

WriteAttribute(String, String, Boolean) WriteAttribute(String, String, Boolean) WriteAttribute(String, String, Boolean) 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) WriteAttribute(String, String) WriteAttribute(String, String) WriteAttribute(String, String)

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

WriteAttribute(String, String, Boolean) WriteAttribute(String, String, Boolean) WriteAttribute(String, String, Boolean) 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 String String String

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

value
String String String String

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

fEncode
Boolean Boolean Boolean 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) 要素に書き込むオーバーロード<img>を呼び出します。 altCalls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • No "encoding" required myattribute falseオーバーロードを呼び出して、の値を持つカスタム属性をレンダリングし、をにfEncode設定します。 WriteAttribute(String, String, Boolean)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. メソッドは、 HtmlAttributeEncodeメソッドを使用してエンコーディングを実行します。 WriteAttributeThe WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

メソッドWriteAttributeは、二重引用符 (") で囲まれた属性値を書き込みます。The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). WriteAttributevaluenull場合、メソッドは属性名だけを書き込みます。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) WriteAttribute(String, String) WriteAttribute(String, String) 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 String String String

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

value
String String String 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) 要素に書き込むオーバーロード<img>を呼び出します。 altCalls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • No "encoding" required myattribute falseオーバーロードを呼び出して、の値を持つカスタム属性をレンダリングし、をにfEncode設定します。 WriteAttribute(String, String, Boolean)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 ("). WriteAttributevaluenull場合、メソッドは属性名だけを書き込みます。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.

こちらもご覧ください

適用対象