HtmlTextWriter.WriteLine メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

オーバーロードされたパラメーターで指定されたデータを HtmlTextWriter 出力ストリームに書き込み、続けて行終端文字列を書き込みます。 このメソッドのすべてのバージョンで、保留中のタブ空白文字が出力ストリームに書き込まれます。

オーバーロード

WriteLine(String, Object, Object)	保留中のタブ空白文字と 2 つのオブジェクトのテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Char[], Int32, Int32)	保留中のタブ空白文字と Unicode 文字の部分配列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(String, Object[])	保留中のタブ空白文字とオブジェクト配列のテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(String, Object)	保留中のタブ空白文字とオブジェクトのテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(UInt32)	指定したタブ文字列と 4 バイトの符号なし整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(String)	保留中のタブ空白文字とテキスト文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Single)	保留中のタブ空白文字と単精度浮動小数点数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Int32)	指定したタブ文字列と 32 バイトの符号付き整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Int64)	指定したタブ文字列と 64 バイトの符号付き整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Double)	保留中のタブ空白文字と倍精度浮動小数点数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Char[])	保留中のタブ空白文字と Unicode 文字の配列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Char)	保留中のタブ空白文字と Unicode 文字を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine(Boolean)	保留中のタブ空白文字とブール値のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。
WriteLine()	行終端文字列を出力ストリームに書き込みます。
WriteLine(Object)	保留中のタブ空白文字とオブジェクトのテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

WriteLine(String, Object, Object)

保留中のタブ空白文字と 2 つのオブジェクトのテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void WriteLine (string format, object arg0, object arg1);

override this.WriteLine : string * obj * obj -> unit

Public Overrides Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

パラメーター

format

String

0 個以上の書式項目を格納している文字列。

arg0

Object

書式指定するオブジェクト。

arg1

Object

書式指定するオブジェクト。

例

次のコード例では、 メソッドをWriteLine使用して、書式設定された文字列と、 プロパティと プロパティの値をレンダリングする方法をCurrentCultureToday示します。

// Use the WriteLine(string,object,object) method to
// render a formatted string and two objects 
// in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.",
    CultureInfo.CurrentCulture, DateTime.Today);
writer.RenderEndTag();

' Use the WriteLine(string,object,object) method to
' render a formatted string and two objects 
' in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.", _
    CultureInfo.CurrentCulture, DateTime.Today)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 メソッドは WriteLine 、 メソッドと同じセマンティクスを Format(String, Object, Object) 使用します。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[], Int32, Int32)

保留中のタブ空白文字と Unicode 文字の部分配列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(cli::array <char> ^ buffer, int index, int count);

public override void WriteLine (char[] buffer, int index, int count);

override this.WriteLine : char[] * int * int -> unit

Public Overrides Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

パラメーター

buffer

Char[]

出力ストリームにテキストを書き込む文字配列。

index

Int32

書き込みを開始する文字配列内の位置。

count

Int32

出力ストリームに書き込む配列内の文字数。

例

このセクションには、2 つのコード例が含まれています。 最初の例では、文字配列を作成する方法を示します。 2 つ目は、配列の使用方法を示しています。

これらのコード例では、次のマークアップが生成されます。

<label>

hello

</label>

次のコード例では、 を入力 hello worldする文字の配列を作成する方法を示します。 配列に含まれるフィールド SpaceChar は、2 つの単語の間にスペースを作成します。

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};

Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

次のコード例では、 index メソッドの および count パラメーターを WriteLine 使用して、前のコード例で作成した配列の最初の 5 文字をレンダリングします。

// Render a subarray of a character array
// as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars, 0, 5);
writer.RenderEndTag();

' Render a subarray of a character array
' as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars, 0, 5)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object[])

保留中のタブ空白文字とオブジェクト配列のテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void WriteLine (string format, params object[] arg);

override this.WriteLine : string * obj[] -> unit

Public Overrides Sub WriteLine (format As String, ParamArray arg As Object())

パラメーター

format

String

0 個以上の書式項目を格納している文字列。

arg

Object[]

書式設定するオブジェクト配列。

例

このセクションには、2 つのコード例が含まれています。 最初の例では、文字列と配列を出力ストリームにレンダリングする方法を示します。 2 つ目は、配列を宣言する方法を示しています。

次のコード例では、 メソッドを WriteLine 使用して、書式設定された文字列とオブジェクト配列の内容を出力ストリームにレンダリングする方法を示します。

// Render a formatted string and the
// text representation of an object array,
// myObjectArray, as the contents of
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime);
writer.RenderEndTag();

' Render a formatted string and the
' text representation of an object array,
' myObjectArray, as the contents of
' a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

次のコード例は、前のコード例でレンダリングされたオブジェクト配列を宣言する方法を示しています。

private object[] curPriceTime = {4.25, DateTime.Now};

Private curPriceTime() As Object = {4.25, DateTime.Now}

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 メソッドは WriteLine 、 メソッドと同じセマンティクスを Format(String, Object[]) 使用します。 WriteLine基本メソッドは、 メソッドの記述に使用されますvalue。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object)

保留中のタブ空白文字とオブジェクトのテキスト形式を格納する書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0);

public override void WriteLine (string format, object arg0);

override this.WriteLine : string * obj -> unit

Public Overrides Sub WriteLine (format As String, arg0 As Object)

パラメーター

format

String

0 個以上の書式項目を格納している文字列。

arg0

Object

書式指定するオブジェクト。

例

次のコード例は、 メソッドを使用して、 プロパティの WriteLine 値を使用して書式設定された文字列をレンダリングする方法を CurrentCulture 示しています。

// Use the WriteLine(string, object) method to
// render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}",
    CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the WriteLine(string, object) method to
' render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}.", _
    CultureInfo.CurrentCulture)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 メソッドは WriteLine 、 メソッドと同じセマンティクスを Format(String, Object) 使用します。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(UInt32)

重要

この API は CLS 準拠ではありません。

CLS 準拠の代替

System.Web.UI.HtmlTextWriter.WriteLine(Int64)

指定したタブ文字列と 4 バイトの符号なし整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::UInt32 value);

[System.CLSCompliant(false)]
public override void WriteLine (uint value);

[<System.CLSCompliant(false)>]
override this.WriteLine : uint32 -> unit

Public Overrides Sub WriteLine (value As UInteger)

パラメーター

value

UInt32

出力ストリームに書き込む 4 バイト符号なし整数。

属性

CLSCompliantAttribute

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(String)

保留中のタブ空白文字とテキスト文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::String ^ s);

public override void WriteLine (string s);

override this.WriteLine : string -> unit

Public Overrides Sub WriteLine (s As String)

パラメーター

s

String

出力ストリームに書き込む文字列。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Single)

保留中のタブ空白文字と単精度浮動小数点数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(float value);

public override void WriteLine (float value);

override this.WriteLine : single -> unit

Public Overrides Sub WriteLine (value As Single)

パラメーター

value

Single

出力ストリームに書き込む単精度浮動小数点数。

例

次のコード例は、 メソッドを WriteLine 使用して、構造体の Single.Epsilon 可能な限り小さい値である フィールドの値をレンダリングする方法を Single 示しています。

このコード例では、次のマークアップを生成します。

<b>

1.401298E-45

</b>

// Use the WriteLine(Single) method to render the
// Epsilon field of the Single structure.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(Single.Epsilon);
writer.RenderEndTag();

' Use the WriteLine(Single) method to render the
' Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(Single.Epsilon)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Int32)

指定したタブ文字列と 32 バイトの符号付き整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(int value);

public override void WriteLine (int value);

override this.WriteLine : int -> unit

Public Overrides Sub WriteLine (value As Integer)

パラメーター

value

Int32

出力ストリームに書き込む 32 バイト符号付き整数。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Int64)

指定したタブ文字列と 64 バイトの符号付き整数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(long value);

public override void WriteLine (long value);

override this.WriteLine : int64 -> unit

Public Overrides Sub WriteLine (value As Long)

パラメーター

value

Int64

出力ストリームに書き込む 64 バイト符号付き整数。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターの書き込みにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Double)

保留中のタブ空白文字と倍精度浮動小数点数のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(double value);

public override void WriteLine (double value);

override this.WriteLine : double -> unit

Public Overrides Sub WriteLine (value As Double)

パラメーター

value

Double

出力ストリームに書き込む倍精度浮動小数点数。

例

次のコード例は、 メソッドを WriteLine 使用して フィールドの値をレンダリングする方法を Double.MaxValue 示しています。

このコード例では、次のマークアップを生成します。

<label>

1.79769313486232E+308

</label>

// Use the WriteLine(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(Double.MaxValue);
writer.RenderEndTag();

' Use the WriteLine(Double) method to render
' the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(Double.MaxValue)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[])

保留中のタブ空白文字と Unicode 文字の配列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(cli::array <char> ^ buffer);

public override void WriteLine (char[] buffer);

override this.WriteLine : char[] -> unit

Public Overrides Sub WriteLine (buffer As Char())

パラメーター

buffer

Char[]

出力ストリームに書き込む文字配列。

例

このセクションでは、2 つのコード例を示します。 1 つ目は、配列を作成する方法を示しています。 2 つ目は、その配列の使用方法を示しています。

これらのコード例では、次のマークアップが生成されます。

<label>

hello world

</label>

次のコード例は、 を入力 hello worldする文字の配列を作成する方法を示しています。 配列に含まれるフィールド SpaceChar は、2 つの単語の間にスペースを作成します。

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};

Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

次のコード例では、 メソッドを hello world 使用して、前の例で作成した文字配列を WriteLine レンダリングします。

// Render a character array as the contents of 
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars);
writer.RenderEndTag();

' Render a character array as the 
' contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Char)

保留中のタブ空白文字と Unicode 文字を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(char value);

public override void WriteLine (char value);

override this.WriteLine : char -> unit

Public Overrides Sub WriteLine (value As Char)

パラメーター

value

Char

出力ストリームに書き込む文字。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Boolean)

保留中のタブ空白文字とブール値のテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(bool value);

public override void WriteLine (bool value);

override this.WriteLine : bool -> unit

Public Overrides Sub WriteLine (value As Boolean)

パラメーター

value

Boolean

出力ストリームに書き込むブール値。

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine()

行終端文字列を出力ストリームに書き込みます。

public:
 override void WriteLine();

public override void WriteLine ();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

例

次のコード例では、 メソッドを使用して、要素が WriteLine レンダリングされた後に行を挿入する方法を <img> 示します。

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 詳細については、「WriteLine」を参照してください。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine

WriteLine(Object)

保留中のタブ空白文字とオブジェクトのテキスト形式を出力ストリームに書き込み、続けて行終端文字列を書き込みます。

public:
 override void WriteLine(System::Object ^ value);

public override void WriteLine (object value);

override this.WriteLine : obj -> unit

Public Overrides Sub WriteLine (value As Object)

パラメーター

value

Object

出力ストリームに書き込むオブジェクト。

例

次のコード例は、 メソッドを使用 WriteLine して プロパティの値を CultureInfo.CurrentCulture コントロールにレンダリングする方法を示しています。

// Use the WriteLine method to render an arbitrary
// object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the WriteLine method to render an arbitrary
' object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(CultureInfo.CurrentCulture)
writer.RenderEndTag()

注釈

既定の行ターミネータ文字列は、復帰の後に改行 ("\r\n") が続きます。 WriteLine基本メソッドは、 パラメーターを書き込むのにvalue使用されます。

こちらもご覧ください

• NewLine
• TextWriter
• WriteLine