HtmlTextWriter.WriteLine Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zapíše data do výstupního datového HtmlTextWriter proudu, jak je určeno přetíženými parametry, následované řetězcem ukončovače řádku. Všechny verze této metody zapisují všechny čekající mezery mezi kartami do výstupního datového proudu.

Přetížení

WriteLine(String, Object, Object)	Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec, který obsahuje textovou reprezentaci dvou objektů, následované řetězcem ukončovací čáry, do výstupního datového proudu.
WriteLine(Char[], Int32, Int32)	Zapíše všechny čekající mezery mezi tabulátory a dílčí pole znaků Unicode, následované řetězcem ukončovací čáry, do výstupního datového proudu.
WriteLine(String, Object[])	Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec, který obsahuje textovou reprezentaci pole objektu následovaný řetězcem ukončovací čáry, do výstupního datového proudu.
WriteLine(String, Object)	Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec obsahující textovou reprezentaci objektu, následovaný řetězcem ukončovací čáry, do výstupního datového proudu.
WriteLine(UInt32)	Zapíše všechny čekající mezery mezi tabulátory a textovou reprezentaci 4 bajtového celého čísla bez znaménka následované řetězcem ukončovací čáry řádku do výstupního datového proudu.
WriteLine(String)	Zapíše všechny čekající mezery mezi tabulátory a textový řetězec následovaný řetězcem ukončení řádku do výstupního datového proudu.
WriteLine(Single)	Zapíše všechny čekající mezery mezi tabulátory a textové vyjádření čísla s plovoucí desetinnou čárkou s jednoduchou přesností následované řetězcem ukončovací čáry do výstupního datového proudu.
WriteLine(Int32)	Zapíše do výstupního datového proudu všechny čekající mezery mezi tabulátory a textovou reprezentaci 32 bajtů podepsaného celého čísla následovaného řetězcem ukončovací čáry.
WriteLine(Int64)	Zapíše do výstupního datového proudu všechny čekající mezery mezi tabulátory a textovou reprezentaci 64 bajtů podepsaného celého čísla následovaného řetězcem ukončovací čáry.
WriteLine(Double)	Zapíše všechny čekající mezery mezi tabulátory a textové vyjádření čísla s plovoucí desetinnou čárkou s dvojitou přesností následované řetězcem ukončovací čáry do výstupního datového proudu.
WriteLine(Char[])	Zapíše všechny čekající mezery mezi tabulátory a pole znaků Unicode následované řetězcem ukončovací čáry do výstupního datového proudu.
WriteLine(Char)	Zapíše všechny čekající mezery mezi tabulátory a znak Unicode následovaný řetězcem ukončovací čáry do výstupního datového proudu.
WriteLine(Boolean)	Zapíše všechny čekající mezery mezi tabulátory a textovou reprezentaci logické hodnoty následované řetězcem ukončovací čáry do výstupního datového proudu.
WriteLine()	Zapíše řetězec ukončovací čáry do výstupního datového proudu.
WriteLine(Object)	Zapíše všechny čekající mezery mezi tabulátory a textovou reprezentaci objektu, následované řetězcem ukončovací čáry, do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

WriteLine(String, Object, Object)

Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec, který obsahuje textovou reprezentaci dvou objektů, následované řetězcem ukončovací čáry, do výstupního datového proudu.

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)

Parametry

format: String

Řetězec obsahující nula nebo více položek formátu.

arg0: Object

Objekt, který se má formátovat.

arg1: Object

Objekt, který se má formátovat.

Příklady

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vykreslení formátovaného řetězce a hodnoty CurrentCulture vlastnosti a Today vlastnosti.

// 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()

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Metoda WriteLine používá stejnou sémantiku Format(String, Object, Object) jako metoda . Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Char[], Int32, Int32)

Zapíše všechny čekající mezery mezi tabulátory a dílčí pole znaků Unicode, následované řetězcem ukončovací čáry, do výstupního datového proudu.

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)

Parametry

buffer: Char[]

Pole znaků, ze kterého chcete zapsat text do výstupního datového proudu.

index: Int32

Umístění v poli znaků, kde začíná psaní.

count: Int32

Počet znaků v poli pro zápis do výstupního datového proudu.

Příklady

Tato část obsahuje dva příklady kódu. První z nich ukazuje, jak vytvořit pole znaků. Druhý ukazuje, jak pole použít.

Tyto příklady kódu generují následující kód:

<label>

hello

</label>

Následující příklad kódu ukazuje, jak vytvořit pole znaků, které hláskovat hello world. Pole je SpaceChar součástí pole, které vytváří mezeru mezi těmito dvěma slovy.

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}

Následující příklad kódu používá index parametry WriteLine a count metody k vykreslení prvních pěti znaků pole vytvořeného v předchozím příkladu kódu.

// 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()

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(String, Object[])

Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec, který obsahuje textovou reprezentaci pole objektu následovaný řetězcem ukončovací čáry, do výstupního datového proudu.

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())

Parametry

format: String

Řetězec obsahující nula nebo více položek formátu.

arg: Object[]

Pole objektů, které se mají formátovat.

Příklady

Tato část obsahuje dva příklady kódu. První z nich ukazuje, jak vykreslit řetězec a pole do výstupního datového proudu. Druhý ukazuje, jak deklarovat pole.

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vykreslení formátovaného řetězce a obsah pole objektu do výstupního datového proudu.

// 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()

Následující příklad kódu ukazuje, jak deklarovat pole objektu, který byl vykreslen v předchozím příkladu kódu.

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

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

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Metoda WriteLine používá stejnou sémantiku Format(String, Object[]) jako metoda . Základní WriteLine metoda se používá k zápisu value metody .

Viz také

Platí pro

WriteLine(String, Object)

Zapíše všechny čekající mezery mezi tabulátory a formátovaný řetězec obsahující textovou reprezentaci objektu, následovaný řetězcem ukončovací čáry, do výstupního datového proudu.

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)

Parametry

format: String

Řetězec obsahující nula nebo více položek formátu.

arg0: Object

Objekt, který se má formátovat.

Příklady

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vykreslení formátovaného řetězce s hodnotou CurrentCulture vlastnosti .

// 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()

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Metoda WriteLine používá stejnou sémantiku Format(String, Object) jako metoda . Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(UInt32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS: System.Web.UI.HtmlTextWriter.WriteLine(Int64)

Zapíše všechny čekající mezery mezi tabulátory a textovou reprezentaci 4 bajtového celého čísla bez znaménka následované řetězcem ukončovací čáry řádku do výstupního datového proudu.

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)

Parametry

value: UInt32

4 bajtové celé číslo bez znaménka pro zápis do výstupního datového proudu.

Atributy: CLSCompliantAttribute

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(String)

Zapíše všechny čekající mezery mezi tabulátory a textový řetězec následovaný řetězcem ukončení řádku do výstupního datového proudu.

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)

Parametry

s: String

Řetězec pro zápis do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Single)

Zapíše všechny čekající mezery mezi tabulátory a textové vyjádření čísla s plovoucí desetinnou čárkou s jednoduchou přesností následované řetězcem ukončovací čáry do výstupního datového proudu.

public:
 override void WriteLine(float value);

public override void WriteLine (float value);

override this.WriteLine : single -> unit

Public Overrides Sub WriteLine (value As Single)

Parametry

value: Single

Číslo s plovoucí desetinou čárkou s jednoduchou přesností pro zápis do výstupního datového proudu.

Příklady

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vykreslení hodnoty Single.Epsilon pole, což je nejmenší možná hodnota Single struktury.

Tento příklad kódu vygeneruje následující kód:

<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()

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Int32)

Zapíše do výstupního datového proudu všechny čekající mezery mezi tabulátory a textovou reprezentaci 32 bajtů podepsaného celého čísla následovaného řetězcem ukončovací čáry.

public:
 override void WriteLine(int value);

public override void WriteLine (int value);

override this.WriteLine : int -> unit

Public Overrides Sub WriteLine (value As Integer)

Parametry

value: Int32

Celé 32 bajtů se signýmým kódem pro zápis do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Int64)

Zapíše do výstupního datového proudu všechny čekající mezery mezi tabulátory a textovou reprezentaci 64 bajtů podepsaného celého čísla následovaného řetězcem ukončovací čáry.

public:
 override void WriteLine(long value);

public override void WriteLine (long value);

override this.WriteLine : int64 -> unit

Public Overrides Sub WriteLine (value As Long)

Parametry

value: Int64

64 bajtů podepsané celé číslo pro zápis do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončování řádků je návrat na začátek řádku následovaný odřádkováním ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Double)

Zapíše všechny čekající mezery mezi kartami a textovou reprezentaci čísla s plovoucí desetinnou čárkou s dvojitou přesností následované řetězcem ukončovací čáry do výstupního datového proudu.

public:
 override void WriteLine(double value);

public override void WriteLine (double value);

override this.WriteLine : double -> unit

Public Overrides Sub WriteLine (value As Double)

Parametry

value: Double

Číslo s plovoucí desetinou čárkou s dvojitou přesností pro zápis do výstupního datového proudu.

Příklady

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vykreslení hodnoty Double.MaxValue pole.

Tento příklad kódu vygeneruje následující kód:

<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()

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Char[])

Zapíše všechny čekající mezery mezi kartami a pole znaků Unicode následované řetězcem ukončovače řádku do výstupního datového proudu.

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())

Parametry

buffer: Char[]

Pole znaků pro zápis do výstupního datového proudu

Příklady

Tato část obsahuje dva příklady kódu. První z nich ukazuje, jak vytvořit pole. Druhý ukazuje, jak toto pole používat.

Tyto příklady kódu vygenerují následující kód:

<label>

hello world

</label>

Následující příklad kódu ukazuje, jak vytvořit pole znaků, které hláskovat hello world. Součástí pole je SpaceChar pole, které vytvoří mezeru mezi dvěma slovy.

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}

Následující příklad kódu vykresluje hello world pole znaků vytvořené v předchozím příkladu WriteLine pomocí metody .

// 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()

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Char)

Zapíše všechny čekající mezery mezi kartami a znak Unicode následovaný řetězcem ukončovače řádku do výstupního datového proudu.

public:
 override void WriteLine(char value);

public override void WriteLine (char value);

override this.WriteLine : char -> unit

Public Overrides Sub WriteLine (value As Char)

Parametry

value: Char

Znak pro zápis do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine(Boolean)

Zapíše všechny čekající mezery mezi kartami a textovou reprezentaci logické hodnoty následované řetězcem ukončovače řádku do výstupního datového proudu.

public:
 override void WriteLine(bool value);

public override void WriteLine (bool value);

override this.WriteLine : bool -> unit

Public Overrides Sub WriteLine (value As Boolean)

Parametry

value: Boolean

Logická hodnota pro zápis do výstupního datového proudu.

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro

WriteLine()

Zapíše řetězec ukončovače řádku do výstupního datového proudu.

public:
 override void WriteLine();

public override void WriteLine ();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

Příklady

Následující příklad kódu ukazuje, jak použít metodu WriteLine k vložení řádku po vykreslení elementu <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()

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Další informace naleznete v tématu WriteLine.

Viz také

Platí pro

WriteLine(Object)

Zapíše všechny čekající mezery mezi kartami a textovou reprezentaci objektu následované řetězcem ukončovače řádku do výstupního datového proudu.

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)

Parametry

value: Object

Objekt pro zápis do výstupního datového proudu.

Příklady

Následující příklad kódu ukazuje, jak pomocí WriteLine metody vykreslit hodnotu CultureInfo.CurrentCulture vlastnosti na ovládací prvek.

// 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()

Poznámky

Výchozí řetězec ukončovače řádku je návrat řádku následovaný kanálem řádku ("\r\n"). Základní WriteLine metoda se používá k zápisu parametru value .

Viz také

Platí pro