HtmlTextWriter.Write Methode

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt den angegebenen Datentyp zusammen mit einem ausstehenden Tabstoppabstand in den Ausgabedatenstrom.

Überlädt

Name	Beschreibung
Write(Boolean)	Schreibt die Textdarstellung eines booleschen Werts in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Char)	Schreibt die Textdarstellung eines Unicode-Zeichens in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Char[])	Schreibt die Textdarstellung eines Arrays von Unicode-Zeichen in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Double)	Schreibt die Textdarstellung einer Gleitkommazahl mit doppelter Genauigkeit in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Int32)	Schreibt die Textdarstellung einer mit 32 Byte signierten ganzzahligen Zahl in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Int64)	Schreibt die Textdarstellung einer signierten 64-Byte-Ganzzahl in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Object)	Schreibt die Textdarstellung eines Objekts in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(Single)	Schreibt die Textdarstellung einer Gleitkommazahl mit einfacher Genauigkeit in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(String)	Schreibt die angegebene Zeichenfolge zusammen mit einem ausstehenden Tabstoppabstand in den Ausgabedatenstrom.
Write(String, Object)	Schreibt eine Tabstoppzeichenfolge und eine formatierte Zeichenfolge in den Ausgabedatenstrom, wobei die gleiche Semantik wie die Format(String, Object) Methode verwendet wird, zusammen mit einem ausstehenden Tabstoppabstand.
Write(String, Object[])	Schreibt eine formatierte Zeichenfolge, die die Textdarstellung eines Objektarrays in den Ausgabedatenstrom enthält, zusammen mit einem ausstehenden Tabstoppabstand. Diese Methode verwendet dieselbe Semantik wie die Format(String, Object[]) Methode.
Write(Char[], Int32, Int32)	Schreibt die Textdarstellung einer Unterarray von Unicode-Zeichen in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.
Write(String, Object, Object)	Schreibt eine formatierte Zeichenfolge, die die Textdarstellung von zwei Objekten in den Ausgabedatenstrom enthält, zusammen mit einem ausstehenden Tabstoppabstand. Diese Methode verwendet dieselbe Semantik wie die Format(String, Object, Object) Methode.

Write(Boolean)

Schreibt die Textdarstellung eines booleschen Werts in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 in den Ausgabedatenstrom zu schreibende Datenstrom.

Hinweise

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

Weitere Informationen

TextWriter

Gilt für:

Write(Char)

Schreibt die Textdarstellung eines Unicode-Zeichens in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Unicode-Zeichen, das in den Ausgabedatenstrom geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Write Methode zum Beenden des öffnenden Tags eines <img> Elements mithilfe der TagRightChar Konstante veranschaulicht.

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

TextWriter

Gilt für:

Write(Char[])

Schreibt die Textdarstellung eines Arrays von Unicode-Zeichen in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Array von Unicode-Zeichen, die in den Ausgabedatenstrom geschrieben werden sollen.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten wird veranschaulicht, wie sie ein Array von Zeichen erstellen. Im zweiten wird die Verwendung des Arrays veranschaulicht.

In diesen Codebeispielen wird das folgende Markup generiert:

<label>

hello world

</label>

Im folgenden Codebeispiel wird veranschaulicht, wie sie ein Array von Zeichen erstellen, das rechtschreibt 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 die Write Methode verwendet wird, um das hello world im vorherigen Codebeispiel erstellte Zeichenarray auf einer Seite zu rendern, wenn das Steuerelement, das diesen Beispielcode enthält, auf 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

TextWriter

Gilt für:

Write(Double)

Schreibt die Textdarstellung einer Gleitkommazahl mit doppelter Genauigkeit in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Ausgabedatenstrom geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Write die Methode zum Rendern des Werts des Double.MaxValue Felds verwendet wird.

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

TextWriter

Gilt für:

Write(Int32)

Schreibt die Textdarstellung einer mit 32 Byte signierten ganzzahligen Zahl in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 mit 32 Byte signierte ganze Zahl, die in den Ausgabedatenstrom geschrieben werden soll.

Hinweise

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

Weitere Informationen

TextWriter

Gilt für:

Write(Int64)

Schreibt die Textdarstellung einer signierten 64-Byte-Ganzzahl in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 mit 64 Byte signierte ganze Zahl, die in den Ausgabedatenstrom geschrieben werden soll.

Hinweise

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

Weitere Informationen

TextWriter

Gilt für:

Write(Object)

Schreibt die Textdarstellung eines Objekts in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Ausgabedatenstrom geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Write die Methode zum Rendern des Werts der CultureInfo.CurrentCulture Eigenschaft verwendet wird.

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 in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Ausgabedatenstrom geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Write Methode verwendet wird, um den Wert des Single.Epsilon Felds zu rendern, bei dem es sich um den kleinsten möglichen Wert der Single Struktur handelt.

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

TextWriter

Gilt für:

Write(String)

Schreibt die angegebene Zeichenfolge zusammen mit einem ausstehenden Tabstoppabstand in den Ausgabedatenstrom.

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 Ausgabedatenstrom geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Write Methode zum Rendern einer Zeichenfolge zwischen den öffnenden und schließenden Tags eines benutzerdefinierten Markupelements veranschaulicht.

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

TextWriter

Gilt für:

Write(String, Object)

Schreibt eine Tabstoppzeichenfolge und eine formatierte Zeichenfolge in den Ausgabedatenstrom, wobei die gleiche Semantik wie die Format(String, Object) Methode verwendet wird, zusammen mit einem ausstehenden Tabstoppabstand.

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, die Null- oder mehr Formatelemente enthält.

arg0: Object

Ein zu formatierende Objekt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der Write Methode eine formatierte Zeichenfolge mit dem Wert der CurrentCulture Eigenschaft 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 in den Ausgabedatenstrom enthält, zusammen mit einem ausstehenden Tabstoppabstand. Diese Methode verwendet dieselbe 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, die Null- oder mehr Formatelemente enthält.

arg: Object[]

Ein zu formatierende Objektarray.

Beispiele

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

Das folgende Codebeispiel zeigt, wie die Write Methode zum Rendern einer formatierten Zeichenfolge und des Inhalts eines Objektarrays mit dem Namen curPriceTimeverwendet wird. Der Methodenaufruf rendert das zweite Element des Arrays, bevor es das erste Element rendert.

// 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 einer Unterarray von Unicode-Zeichen in den Ausgabedatenstrom zusammen mit einem ausstehenden Tabstoppabstand.

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 Array von Zeichen, aus denen Text in den Ausgabedatenstrom geschrieben werden soll.

index: Int32

Die Indexposition im Array, an der das Schreiben beginnt.

count: Int32

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

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten wird das Erstellen eines Zeichenarrays veranschaulicht. Im zweiten wird die Verwendung des Arrays veranschaulicht.

In diesen Codebeispielen wird das folgende Markup generiert:

<label>

hello

</label>

Im folgenden Codebeispiel wird gezeigt, wie Sie ein Array von Zeichen erstellen, das rechtschreibt 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}

Der folgende Teil des Codebeispiels verwendet die index und count die Parameter der Write Methode, 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

TextWriter

Gilt für:

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge, die die Textdarstellung von zwei Objekten in den Ausgabedatenstrom enthält, zusammen mit einem ausstehenden Tabstoppabstand. Diese Methode verwendet dieselbe 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, die Null- oder mehr Formatelemente enthält.

arg0: Object

Ein zu formatierende Objekt.

arg1: Object

Ein zu formatierende Objekt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Write Methode zum Rendern einer formatierten Zeichenfolge und der Werte der CurrentCulture Eigenschaften Today verwendet wird.

// 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:

Feedback

War diese Seite hilfreich?

Freigeben über

HtmlTextWriter.Write Methode

Definition

Überlädt

Write(Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Write(Char)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(Char[])

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(Double)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(Int32)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Write(Int64)

Parameter

Hinweise

Weitere Informationen

Gilt für:

Write(Object)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(Single)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(String, Object)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(String, Object[])

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(Char[], Int32, Int32)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(String, Object, Object)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback