Udostępnij za pośrednictwem


HtmlTextWriter.Write Metoda

Definicja

Zapisuje określony typ danych do strumienia wyjściowego wraz ze wszystkimi oczekującymi odstępami między kartami.

Przeciążenia

Write(Boolean)

Zapisuje tekstową reprezentację wartości logicznej w strumieniu wyjściowym wraz ze wszystkimi oczekującymi odstępami tabulatorów.

Write(Char)

Zapisuje tekstową reprezentację znaku Unicode w strumieniu wyjściowym wraz ze wszystkimi oczekującymi odstępami tabulatorów.

Write(Char[])

Zapisuje tekstową reprezentację tablicy znaków Unicode w strumieniu wyjściowym wraz z dowolnymi odstępami między kartami oczekującymi.

Write(Double)

Zapisuje reprezentację tekstową liczby zmiennoprzecinkowe o podwójnej precyzji do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

Write(Int32)

Zapisuje reprezentację tekstową 32-bajtowej liczby całkowitej ze znakiem do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

Write(Int64)

Zapisuje tekstową reprezentację 64-bajtowej liczby całkowitej ze znakiem do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

Write(Object)

Zapisuje tekstową reprezentację obiektu w strumieniu wyjściowym wraz z dowolnym oczekującym odstępem między kartami.

Write(Single)

Zapisuje reprezentację tekstową liczby zmiennoprzecinkowa o pojedynczej precyzji do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

Write(String)

Zapisuje określony ciąg do strumienia wyjściowego wraz ze wszystkimi oczekującymi odstępami między kartami.

Write(String, Object)

Zapisuje ciąg tabulatora i sformatowany ciąg do strumienia wyjściowego przy użyciu tej samej semantyki co Format(String, Object) metoda wraz z dowolnym oczekującym odstępem tabulatora.

Write(String, Object[])

Zapisuje sformatowany ciąg, który zawiera reprezentację tekstową tablicy obiektów w strumieniu wyjściowym, wraz z dowolnym oczekującym odstępem między kartami. Ta metoda używa tej samej semantyki co Format(String, Object[]) metoda .

Write(Char[], Int32, Int32)

Zapisuje tekstową reprezentację podtablicy znaków Unicode do strumienia wyjściowego wraz z dowolnym oczekującym odstępem tabulatora.

Write(String, Object, Object)

Zapisuje sformatowany ciąg, który zawiera reprezentację tekstową dwóch obiektów w strumieniu wyjściowym, wraz z dowolnym oczekującym odstępem między kartami. Ta metoda używa tej samej semantyki co Format(String, Object, Object) metoda .

Write(Boolean)

Zapisuje tekstową reprezentację wartości logicznej w strumieniu wyjściowym wraz ze wszystkimi oczekującymi odstępami tabulatorów.

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

Parametry

value
Boolean

Element Boolean do zapisu w strumieniu wyjściowym.

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Char)

Zapisuje tekstową reprezentację znaku Unicode w strumieniu wyjściowym wraz ze wszystkimi oczekującymi odstępami tabulatorów.

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

Parametry

value
Char

Znak Unicode do zapisu w strumieniu wyjściowym.

Przykłady

W poniższym przykładzie kodu pokazano użycie Write metody w celu zakończenia tagu <img> otwierania elementu przy użyciu stałej TagRightChar .

Ten przykład kodu renderuje następujące znaczniki:

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Char[])

Zapisuje tekstową reprezentację tablicy znaków Unicode w strumieniu wyjściowym wraz z dowolnymi odstępami między kartami oczekującymi.

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

Parametry

buffer
Char[]

Tablica znaków Unicode do zapisu w strumieniu wyjściowym.

Przykłady

Ta sekcja zawiera dwa przykłady kodu. Pierwszy pokazuje, jak utworzyć tablicę znaków. Drugi demonstruje sposób używania tablicy.

Te przykłady kodu generują następujące znaczniki:

<label>

hello world

</label>

W poniższym przykładzie kodu pokazano, jak utworzyć tablicę znaków z pisownią hello world. Uwzględniona w tablicy jest SpaceChar polem, które tworzy spację między dwoma wyrazami.

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}

W poniższym przykładzie kodu pokazano, jak za pomocą Write metody renderować tablicę hello world znaków utworzoną w poprzednim przykładzie kodu na stronie, gdy kontrolka zawierająca ten przykładowy kod znajduje się na stronie.

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Double)

Zapisuje reprezentację tekstową liczby zmiennoprzecinkowe o podwójnej precyzji do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

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

Parametry

value
Double

Liczba zmiennoprzecinkowa o podwójnej precyzji do zapisu w strumieniu wyjściowym.

Przykłady

Poniższy przykład kodu pokazuje, jak użyć Write metody do renderowania wartości Double.MaxValue pola.

W tym przykładzie kodu są generowane następujące znaczniki:

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Int32)

Zapisuje reprezentację tekstową 32-bajtowej liczby całkowitej ze znakiem do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

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

Parametry

value
Int32

Liczba całkowita ze znakiem 32 bajtów do zapisu w strumieniu wyjściowym.

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Int64)

Zapisuje tekstową reprezentację 64-bajtowej liczby całkowitej ze znakiem do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

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

Parametry

value
Int64

Liczba całkowita ze znakiem 64 bajtów do zapisu w strumieniu wyjściowym.

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Object)

Zapisuje tekstową reprezentację obiektu w strumieniu wyjściowym wraz z dowolnym oczekującym odstępem między kartami.

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)

Parametry

value
Object

Obiekt do zapisu w strumieniu wyjściowym.

Przykłady

Poniższy przykład kodu pokazuje, jak użyć Write metody do renderowania wartości CultureInfo.CurrentCulture właściwości.

W tym przykładzie kodu są generowane następujące znaczniki:

This is a rendered CultureInfo object.

<bold>

Wartość CurrentCulture właściwości:

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Single)

Zapisuje reprezentację tekstową liczby zmiennoprzecinkowa o pojedynczej precyzji do strumienia wyjściowego wraz z dowolnym oczekującym odstępem między kartami.

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

Parametry

value
Single

Liczba zmiennoprzecinkowa o pojedynczej precyzji do zapisu w strumieniu wyjściowym.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć Write metody do renderowania wartości Single.Epsilon pola, która jest najmniejszą możliwą wartością Single struktury.

W tym przykładzie kodu są generowane następujące znaczniki:

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(String)

Zapisuje określony ciąg do strumienia wyjściowego wraz ze wszystkimi oczekującymi odstępami między kartami.

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)

Parametry

s
String

Ciąg do zapisu w strumieniu wyjściowym.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą Write metody renderować ciąg między tagami otwierającymi i zamykającymi elementu znaczników niestandardowych.

W tym przykładzie kodu są generowane następujące znaczniki:

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(String, Object)

Zapisuje ciąg tabulatora i sformatowany ciąg do strumienia wyjściowego przy użyciu tej samej semantyki co Format(String, Object) metoda wraz z dowolnym oczekującym odstępem tabulatora.

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)

Parametry

format
String

Ciąg zawierający zero lub więcej elementów formatu.

arg0
Object

Obiekt do sformatowania.

Przykłady

Poniższy przykład kodu pokazuje, jak użyć Write metody do renderowania sformatowanego ciągu z wartością CurrentCulture właściwości .

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(String, Object[])

Zapisuje sformatowany ciąg, który zawiera reprezentację tekstową tablicy obiektów w strumieniu wyjściowym, wraz z dowolnym oczekującym odstępem między kartami. Ta metoda używa tej samej semantyki co Format(String, Object[]) metoda .

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

Parametry

format
String

Ciąg zawierający zero lub więcej elementów formatu.

arg
Object[]

Tablica obiektów do sformatowania.

Przykłady

Ten rozdział zawiera dwa przykłady kodu. Pierwszy pokazuje, jak renderować sformatowany ciąg i zawartość tablicy. Drugi demonstruje sposób deklarowania tablicy.

Poniższy przykład kodu pokazuje, jak użyć Write metody do renderowania sformatowanego ciągu i zawartości tablicy obiektów o nazwie curPriceTime. Wywołanie metody renderuje drugi element członkowski tablicy przed renderowaniem pierwszego elementu członkowskiego.

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

Poniższy przykład kodu przedstawia deklarowanie tablicy curPriceTime obiektów.

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(Char[], Int32, Int32)

Zapisuje tekstową reprezentację podtablicy znaków Unicode do strumienia wyjściowego wraz z dowolnym oczekującym odstępem tabulatora.

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)

Parametry

buffer
Char[]

Tablica znaków, z której ma być zapisywany tekst w strumieniu wyjściowym.

index
Int32

Lokalizacja indeksu w tablicy, w której rozpoczyna się zapisywanie.

count
Int32

Liczba znaków do zapisania w strumieniu wyjściowym.

Przykłady

Ta sekcja zawiera dwa przykłady kodu. Pierwszy pokazuje, jak utworzyć tablicę znaków. Drugi demonstruje sposób używania tablicy.

Te przykłady kodu generują następujące znaczniki:

<label>

hello

</label>

W poniższym przykładzie kodu pokazano, jak utworzyć tablicę znaków z pisownią hello world. Uwzględniona w tablicy jest SpaceChar polem, które tworzy spację między dwoma wyrazami.

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}

W poniższej części przykładu kodu użyto index parametrów Write i count metody w celu renderowania pierwszych pięciu znaków tablicy utworzonej w poprzednim przykładzie.

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy

Write(String, Object, Object)

Zapisuje sformatowany ciąg, który zawiera reprezentację tekstową dwóch obiektów w strumieniu wyjściowym, wraz z dowolnym oczekującym odstępem między kartami. Ta metoda używa tej samej semantyki co Format(String, Object, Object) metoda .

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)

Parametry

format
String

Ciąg zawierający zero lub więcej elementów formatu.

arg0
Object

Obiekt do sformatowania.

arg1
Object

Obiekt do sformatowania.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć Write metody do renderowania sformatowanego ciągu oraz wartości CurrentCulture właściwości i Today .

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

Uwagi

Metoda Write generuje wszystkie oczekujące karty, a następnie wywołuje metodę podstawową Write .

Zobacz też

Dotyczy