Freigeben über


HtmlTextWriter.Write Methode

Definition

Schreibt den angegebenen Datentyp zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Überlädt

Write(Boolean)

Schreibt die Textdarstellung eines booleschen Werts zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Char)

Schreibt die Textdarstellung eines Unicode-Zeichens zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Char[])

Schreibt die Textdarstellung eines Arrays von Unicode-Zeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Double)

Schreibt die Textdarstellung einer Gleitkommazahl mit doppelter Genauigkeit zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Int32)

Schreibt die Textdarstellung einer ganze 32-Byte-Zahl mit Vorzeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Int64)

Schreibt die Textdarstellung einer 64-Byte-Ganzzahl mit Vorzeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Object)

Schreibt die Textdarstellung eines Objekts zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(Single)

Schreibt die Textdarstellung einer Gleitkommazahl mit einfacher Genauigkeit zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(String)

Schreibt die angegebene Zeichenfolge zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(String, Object)

Schreibt eine Tabstoppzeichenfolge und eine formatierte Zeichenfolge zusammen mit allen ausstehenden Tabstopps und unter Verwendung derselben Semantik wie die Format(String, Object)-Methode in den Ausgabestream.

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge, die die Textdarstellung eines Objektarrays enthält, zusammen mit allen ausstehenden Tabstopps in den Ausgabestream. Diese Methode verwendet die gleiche Semantik wie die Format(String, Object[])-Methode.

Write(Char[], Int32, Int32)

Schreibt die Textdarstellung eines Teilarrays von Unicode-Zeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge, die die Textdarstellung zweier Objekte enthält, zusammen mit allen ausstehenden Tabstopps in den Ausgabestream. Diese Methode verwendet die gleiche Semantik wie die Format(String, Object, Object)-Methode.

Write(Boolean)

Schreibt die Textdarstellung eines booleschen Werts zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(bool value);
public override void Write (bool value);
override this.Write : bool -> unit
Public Overrides Sub Write (value As Boolean)

Parameter

value
Boolean

Der Boolean, der in den Ausgabestream geschrieben werden soll.

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Char)

Schreibt die Textdarstellung eines Unicode-Zeichens zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(char value);
public override void Write (char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)

Parameter

value
Char

Das in den Ausgabestream zu schreibende Unicode-Zeichen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Write -Methode veranschaulicht, um das öffnende Tag eines <img> Elements mithilfe der TagRightChar -Konstante zu beenden.

In diesem Codebeispiel wird das folgende Markup gerendert:

<img alt="A custom image">

</img>

// Create a manually rendered <img> element
// that contains an alt attribute.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "A custom image.");
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
' Create a manually rendered <img> element
' that contains an alt attribute.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "A custom image.")
writer.Write(HtmlTextWriter.TagRightChar)
writer.WriteEndTag("img")

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Char[])

Schreibt die Textdarstellung eines Arrays von Unicode-Zeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())

Parameter

buffer
Char[]

Das in den Ausgabestream zu schreibende Array von Unicode-Zeichen.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie ein Zeichenarray erstellt wird. Die zweite veranschaulicht die Verwendung des Arrays.

In diesen Codebeispielen wird das folgende Markup generiert:

<label>

hello world

</label>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein Array von Zeichen erstellen, die ausbuchstabieren hello world. Im Array enthalten ist das SpaceChar Feld, das ein Leerzeichen zwischen den beiden Wörtern erstellt.

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}

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Write -Methode verwenden, um das hello world im vorherigen Codebeispiel erstellte Zeichenarray auf einer Seite zu rendern, wenn das Steuerelement, das diesen Beispielcode enthält, in einer Seite enthalten ist.

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

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Double)

Schreibt die Textdarstellung einer Gleitkommazahl mit doppelter Genauigkeit zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(double value);
public override void Write (double value);
override this.Write : double -> unit
Public Overrides Sub Write (value As Double)

Parameter

value
Double

Die Gleitkommazahl mit doppelter Genauigkeit, die in den Ausgabestream geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die Write -Methode verwenden, um den Wert des Double.MaxValue Felds zu rendern.

In diesem Codebeispiel wird das folgende Markup generiert:

<label>

1.79769313486232E+308

</label>

// Use the Write(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(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()

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Int32)

Schreibt die Textdarstellung einer ganze 32-Byte-Zahl mit Vorzeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(int value);
public override void Write (int value);
override this.Write : int -> unit
Public Overrides Sub Write (value As Integer)

Parameter

value
Int32

Die 32-Byte-Ganzzahl mit Vorzeichen, die in den Ausgabestream geschrieben werden soll.

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Int64)

Schreibt die Textdarstellung einer 64-Byte-Ganzzahl mit Vorzeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(long value);
public override void Write (long value);
override this.Write : int64 -> unit
Public Overrides Sub Write (value As Long)

Parameter

value
Int64

Die 64-Byte-Ganzzahl mit Vorzeichen, die in den Ausgabestream geschrieben werden soll.

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Object)

Schreibt die Textdarstellung eines Objekts zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(System::Object ^ value);
public override void Write (object value);
override this.Write : obj -> unit
Public Overrides Sub Write (value As Object)

Parameter

value
Object

Das Objekt, das in den Ausgabestream geschrieben werden soll.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Write -Methode verwenden, um den Wert der CultureInfo.CurrentCulture -Eigenschaft zu rendern.

In diesem Codebeispiel wird das folgende Markup generiert:

This is a rendered CultureInfo object.

<bold>

Der Wert der CurrentCulture Eigenschaft:

</bold>

// Use the Write method to render an arbitrary
// object, in this case a CultureInfo object. 
writer.Write("This is a rendered CultureInfo Object.");
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(CultureInfo.CurrentCulture);
writer.RenderEndTag();
' Use the Write method to render an arbitrary
' object, in this case a CultureInfo object.
writer.Write("This is a rendered CultureInfo Object.")
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(CultureInfo.CurrentCulture)
writer.RenderEndTag()

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Single)

Schreibt die Textdarstellung einer Gleitkommazahl mit einfacher Genauigkeit zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(float value);
public override void Write (float value);
override this.Write : single -> unit
Public Overrides Sub Write (value As Single)

Parameter

value
Single

Die Gleitkommazahl mit einfacher Genauigkeit, die in den Ausgabestream geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie die Write -Methode verwenden, um den Wert des Single.Epsilon Felds zu rendern, der den kleinstmöglichen Wert der Single Struktur darstellt.

In diesem Codebeispiel wird das folgende Markup generiert:

<b>

1.401298E-45

</b>

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

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(String)

Schreibt die angegebene Zeichenfolge zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(System::String ^ s);
public override void Write (string s);
override this.Write : string -> unit
Public Overrides Sub Write (s As String)

Parameter

s
String

Die Zeichenfolge, die in den Ausgabestream geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Write -Methode eine Zeichenfolge zwischen den öffnenden und schließenden Tags eines benutzerdefinierten Markupelements rendern.

In diesem Codebeispiel wird das folgende Markup generiert:

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();
// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();
' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(String, Object)

Schreibt eine Tabstoppzeichenfolge und eine formatierte Zeichenfolge zusammen mit allen ausstehenden Tabstopps und unter Verwendung derselben Semantik wie die Format(String, Object)-Methode in den Ausgabestream.

public:
 override void Write(System::String ^ format, System::Object ^ arg0);
public override void Write (string format, object arg0);
override this.Write : string * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object)

Parameter

format
String

Eine Zeichenfolge mit 0 oder mehr Formatelementen.

arg0
Object

Ein zu formatierendes Objekt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie sie die Write -Methode verwenden, um eine formatierte Zeichenfolge mit dem Wert der CurrentCulture -Eigenschaft zu rendern.

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

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge, die die Textdarstellung eines Objektarrays enthält, zusammen mit allen ausstehenden Tabstopps in den Ausgabestream. Diese Methode verwendet die gleiche Semantik wie die Format(String, Object[])-Methode.

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void Write (string format, params object[] arg);
override this.Write : string * obj[] -> unit
Public Overrides Sub Write (format As String, ParamArray arg As Object())

Parameter

format
String

Eine Zeichenfolge mit 0 oder mehr Formatelementen.

arg
Object[]

Ein zu formatierendes Objektarray.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie eine formatierte Zeichenfolge und der Inhalt eines Arrays gerendert werden. Die zweite veranschaulicht, wie das Array deklariert wird.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Write -Methode eine formatierte Zeichenfolge und den Inhalt eines Objektarrays mit dem Namen rendern curPriceTime. Der Methodenaufruf rendert das zweite Element des Arrays, bevor das erste Element gerendert wird.

// 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.Write("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.Write("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

Im folgenden Codebeispiel wird das Deklarieren des curPriceTime Objektarrays veranschaulicht.

private object[] curPriceTime = {4.25, DateTime.Now};
Private curPriceTime() As Object = {4.25, DateTime.Now}

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(Char[], Int32, Int32)

Schreibt die Textdarstellung eines Teilarrays von Unicode-Zeichen zusammen mit allen ausstehenden Tabstopps in den Ausgabestream.

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write (char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

Parameter

buffer
Char[]

Das Zeichenarray, aus dem Text in den Ausgabestream geschrieben werden soll.

index
Int32

Die Indexposition im Array, bei der mit dem Schreiben begonnen wird.

count
Int32

Die Anzahl der Zeichen, die in den Ausgabestream geschrieben werden sollen.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie ein Zeichenarray erstellt wird. Die zweite veranschaulicht die Verwendung des Arrays.

In diesen Codebeispielen wird das folgende Markup generiert:

<label>

hello

</label>

Das folgende Codebeispiel zeigt, wie Sie ein Array von Zeichen erstellen, die ausbuchstabieren hello world. Im Array enthalten ist das SpaceChar Feld, das ein Leerzeichen zwischen den beiden Wörtern erstellt.

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}

Im folgenden Teil des Codebeispiels werden die index Parameter und count der Write -Methode verwendet, um die ersten fünf Zeichen des arrays zu rendern, das im vorherigen Beispiel erstellt wurde.

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

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für:

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge, die die Textdarstellung zweier Objekte enthält, zusammen mit allen ausstehenden Tabstopps in den Ausgabestream. Diese Methode verwendet die gleiche Semantik wie die Format(String, Object, Object)-Methode.

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void Write (string format, object arg0, object arg1);
override this.Write : string * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

Parameter

format
String

Eine Zeichenfolge mit 0 oder mehr Formatelementen.

arg0
Object

Ein zu formatierendes Objekt.

arg1
Object

Ein zu formatierendes Objekt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die Write -Methode verwendet wird, um eine formatierte Zeichenfolge und die Werte der CurrentCulture Eigenschaften und Today zu rendern.

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

Hinweise

Die Write -Methode generiert alle ausstehenden Registerkarten und ruft dann die Write Basismethode auf.

Weitere Informationen

Gilt für: