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)オーバー ロードでの書き込みが、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、し、設定fEncodefalseします。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 ("). 場合valuenullWriteAttributeメソッドは、属性名のみを書き込みます。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)オーバー ロードでの書き込みが、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、し、設定fEncodefalseします。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 ("). 場合valuenullWriteAttributeメソッドは、属性名のみを書き込みます。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.

こちらもご覧ください

適用対象