HtmlTextWriter.WriteLine Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive dati in un flusso di output di HtmlTextWriter, come specificato dai parametri di overload, seguiti da una stringa del terminatore di riga. Tutte le versioni di questo metodo scrivono qualsiasi spaziatura di tabulazione in sospeso nel flusso di output.

Overload

WriteLine(String, Object, Object)	Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di due oggetti, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Char[], Int32, Int32)	Scrive qualsiasi spaziatura di tabulazione in sospeso e una sottomatrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(String, Object[])	Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di una matrice di oggetti, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(String, Object)	Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(UInt32)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore integer a 4 byte senza segno, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(String)	Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa di testo, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Single)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione singola, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Int32)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un intero con segno a 32 byte, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Int64)	Scrive nel flusso di output qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un intero con segno a 64 byte, seguita da una stringa del terminatore di riga.
WriteLine(Double)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione doppia, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Char[])	Scrive qualsiasi spaziatura di tabulazione in sospeso e una matrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Char)	Scrive qualsiasi spaziatura di tabulazione in sospeso e un carattere Unicode, seguito da una stringa del terminatore di riga, nel flusso di output.
WriteLine(Boolean)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore Boolean, seguita da una stringa del terminatore di riga nel flusso di output.
WriteLine()	Scrive un terminatore di riga nel flusso di output.
WriteLine(Object)	Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

WriteLine(String, Object, Object)

Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di due oggetti, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

format: String

Stringa contenente zero o più elementi di formato.

arg0: Object

Oggetto da formattare.

arg1: Object

Oggetto da formattare.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il metodo per eseguire il WriteLine rendering di una stringa formattata e dei valori della CurrentCulture proprietà e della Today proprietà .

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo usa la stessa semantica del Format(String, Object, Object) metodo . Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(Char[], Int32, Int32)

Scrive qualsiasi spaziatura di tabulazione in sospeso e una sottomatrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

buffer: Char[]

Matrice di caratteri da cui scrivere il testo nel flusso di output.

index: Int32

Posizione di inizio scrittura all'interno della matrice di caratteri.

count: Int32

Numero di caratteri della matrice da scrivere nel flusso di output.

Esempio

In questa sezione sono riportati due esempi di codice. Il primo dimostra come creare una matrice di caratteri. Il secondo dimostra come usare la matrice.

Questi esempi di codice generano il markup seguente:

<label>

hello

</label>

Nell'esempio di codice seguente viene illustrato come creare una matrice di caratteri che specificano hello world. Incluso nella matrice è il SpaceChar campo , che crea uno spazio tra le due parole.

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}

Nell'esempio di codice seguente vengono utilizzati i index parametri e count del WriteLine metodo per eseguire il rendering dei primi cinque caratteri della matrice creata nell'esempio di codice precedente.

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(String, Object[])

Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di una matrice di oggetti, seguita da una stringa del terminatore di riga, nel flusso di output.

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

Parametri

format: String

Stringa contenente zero o più elementi di formato.

arg: Object[]

Matrice di oggetti da formattare.

Esempio

In questa sezione sono riportati due esempi di codice. Il primo illustra come eseguire il rendering di una stringa e di una matrice nel flusso di output. Il secondo mostra come dichiarare la matrice.

Nell'esempio di codice seguente viene illustrato come usare il metodo per eseguire il WriteLine rendering di una stringa formattata e il contenuto di una matrice di oggetti nel flusso di output.

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

Nell'esempio di codice seguente viene illustrato come dichiarare la matrice di oggetti di cui è stato eseguito il rendering nell'esempio di codice precedente.

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

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo usa la stessa semantica del Format(String, Object[]) metodo . Il WriteLine metodo di base viene usato per scrivere il value metodo .

Vedi anche

Si applica a

WriteLine(String, Object)

Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

format: String

Stringa contenente zero o più elementi di formato.

arg0: Object

Oggetto da formattare.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il metodo per eseguire il WriteLine rendering di una stringa formattata con il valore della CurrentCulture proprietà .

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo usa la stessa semantica del Format(String, Object) metodo . Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(UInt32)

Importante

Questa API non è conforme a CLS.

Alternativa conforme a CLS: System.Web.UI.HtmlTextWriter.WriteLine(Int64)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore integer a 4 byte senza segno, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

value: UInt32

Valore integer a 4 byte senza segno da scrivere nel flusso di output.

Attributi: CLSCompliantAttribute

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(String)

Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa di testo, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

s: String

Stringa da scrivere nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(Single)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione singola, seguita da una stringa del terminatore di riga, nel flusso di output.

public:
 override void WriteLine(float value);

public override void WriteLine (float value);

override this.WriteLine : single -> unit

Public Overrides Sub WriteLine (value As Single)

Parametri

value: Single

Numero in virgola mobile e precisione singola da scrivere nel flusso di output.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il WriteLine metodo per eseguire il rendering del Single.Epsilon valore del campo, ovvero il valore più piccolo possibile della Single struttura.

Questo esempio di codice genera il markup seguente:

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(Int32)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un intero con segno a 32 byte, seguita da una stringa del terminatore di riga, nel flusso di output.

public:
 override void WriteLine(int value);

public override void WriteLine (int value);

override this.WriteLine : int -> unit

Public Overrides Sub WriteLine (value As Integer)

Parametri

value: Int32

Valore integer a 32 byte con segno da scrivere nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(Int64)

Scrive nel flusso di output qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un intero con segno a 64 byte, seguita da una stringa del terminatore di riga.

public:
 override void WriteLine(long value);

public override void WriteLine (long value);

override this.WriteLine : int64 -> unit

Public Overrides Sub WriteLine (value As Long)

Parametri

value: Int64

Intero con segno a 64 byte da scrivere nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un avanzamento riga ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro .

Vedi anche

Si applica a

WriteLine(Double)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione doppia, seguita da una stringa del terminatore di riga, nel flusso di output.

public:
 override void WriteLine(double value);

public override void WriteLine (double value);

override this.WriteLine : double -> unit

Public Overrides Sub WriteLine (value As Double)

Parametri

value: Double

Numero in virgola mobile e precisione doppia da scrivere nel flusso di output.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il WriteLine metodo per eseguire il rendering del valore del Double.MaxValue campo.

Questo esempio di codice genera il markup seguente:

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

Vedi anche

Si applica a

WriteLine(Char[])

Scrive qualsiasi spaziatura di tabulazione in sospeso e una matrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output.

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

Parametri

buffer: Char[]

Matrice di caratteri da scrivere nel flusso di output.

Esempio

Questa sezione fornisce due esempi di codice. La prima illustra come creare una matrice. La seconda illustra come usare tale matrice.

Questi esempi di codice generano il markup seguente:

<label>

hello world

</label>

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}

L'esempio di codice seguente esegue il rendering della hello world matrice di caratteri creata nell'esempio precedente usando il WriteLine metodo .

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

Vedi anche

Si applica a

WriteLine(Char)

Scrive qualsiasi spaziatura di tabulazione in sospeso e un carattere Unicode, seguito da una stringa del terminatore di riga, nel flusso di output.

public:
 override void WriteLine(char value);

public override void WriteLine (char value);

override this.WriteLine : char -> unit

Public Overrides Sub WriteLine (value As Char)

Parametri

value: Char

Carattere da scrivere nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

Vedi anche

Si applica a

WriteLine(Boolean)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore Boolean, seguita da una stringa del terminatore di riga nel flusso di output.

public:
 override void WriteLine(bool value);

public override void WriteLine (bool value);

override this.WriteLine : bool -> unit

Public Overrides Sub WriteLine (value As Boolean)

Parametri

value: Boolean

Valore Boolean da scrivere nel flusso di output.

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

Vedi anche

Si applica a

WriteLine()

Scrive un terminatore di riga nel flusso di output.

public:
 override void WriteLine();

public override void WriteLine ();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

Esempio

Nell'esempio di codice seguente viene illustrato come usare il metodo per inserire una riga dopo il WriteLine rendering di un <img> elemento.

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Per altre informazioni, vedere WriteLine.

Vedi anche

Si applica a

WriteLine(Object)

Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output.

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)

Parametri

value: Object

Oggetto da scrivere nel flusso di output.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il metodo per eseguire il WriteLine rendering del CultureInfo.CurrentCulture valore della proprietà in un controllo.

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

Commenti

La stringa di terminazione della riga predefinita è un ritorno a capo seguito da un feed di linee ("\r\n"). Il WriteLine metodo di base viene usato per scrivere il value parametro.

Vedi anche

Si applica a