HtmlTextWriter.Write Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Записывает указанный тип данных в исходящий поток вместе с любым требующимся пространством вкладки.

Перегрузки

Write(Boolean)	Записывает текстовое представление логического значения в исходящий поток вместе с любым требуемым пространством табуляции.
Write(Char)	Записывает текстовое представление символа в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.
Write(Char[])	Записывает текстовое представление массива символов в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.
Write(Double)	Записывает текстовое представление числа с плавающей запятой в исходящий поток вместе с любым требуемым пространством табуляции.
Write(Int32)	Записывает текстовое представление 32-разрядного знакового целого числа в исходящий поток вместе со всеми необходимыми пробелами табуляции.
Write(Int64)	Записывает текстовое представление 64-разрядного целого числа со знаком в исходящий поток вместе со всеми необходимыми пробелами табуляции.
Write(Object)	Записывает текстовое представление объекта в исходящий поток вместе с любым требуемым пространством табуляции.
Write(Single)	Записывает текстовое представление числа с плавающей запятой (одинарная точность) в исходящий поток вместе с любым требуемым пространством табуляции.
Write(String)	Записывает указанную строку в исходящий поток вместе с любым требующимся пространством вкладки.
Write(String, Object)	Записывает строку табуляции и форматированную строку в исходящий поток с помощью той же семантики, что и метод Format(String, Object) вместе с любым требующимся пространством табуляции.
Write(String, Object[])	Записывает форматированную строку, содержащую текстовое представление двух объектов массива в исходящий поток вместе с любым требуемым пространством табуляции. Этот метод использует ту же семантику, что и метод Format(String, Object[]).
Write(Char[], Int32, Int32)	Записывает текстовое представление подмассива символов в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.
Write(String, Object, Object)	Записывает форматированную строку, содержащую текстовое представление двух объектов в исходящий поток вместе с любым требуемым пространством табуляции. Этот метод использует ту же семантику, что и метод Format(String, Object, Object).

Write(Boolean)

Записывает текстовое представление логического значения в исходящий поток вместе с любым требуемым пространством табуляции.

public:
 override void Write(bool value);

public override void Write (bool value);

override this.Write : bool -> unit

Public Overrides Sub Write (value As Boolean)

Параметры

value

Boolean

Boolean для записи в исходящий поток.

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Char)

Записывает текстовое представление символа в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

Параметры

value

Char

Символ в кодировке Юникод для записи в исходящий поток.

Примеры

В следующем примере кода демонстрируется использование Write метода для завершения открывающего тега <img> элемента с помощью константы TagRightChar .

В этом примере кода отображается следующая разметка:

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Char[])

Записывает текстовое представление массива символов в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.

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

Параметры

buffer

Char[]

Массив символов в кодировке Юникод для записи в исходящий поток.

Примеры

В этом разделе приведены два примера кода. В первом из них показано, как создать массив символов. Второй демонстрирует использование массива.

В этих примерах кода создается следующая разметка:

<label>

hello world

</label>

В следующем примере кода показано, как создать массив символов с описанием hello world. В массив входит SpaceChar поле, которое создает пробел между двумя словами.

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}

В следующем примере кода показано, как использовать Write метод для отрисовки hello world массива символов, созданного в предыдущем примере кода, на странице, когда элемент управления, содержащий этот пример кода, включен в страницу.

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Double)

Записывает текстовое представление числа с плавающей запятой в исходящий поток вместе с любым требуемым пространством табуляции.

public:
 override void Write(double value);

public override void Write (double value);

override this.Write : double -> unit

Public Overrides Sub Write (value As Double)

Параметры

value

Double

Число двойной точности с плавающей запятой, записываемое в исходящий поток.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки Double.MaxValue значения поля.

В этом примере кода создается следующая разметка:

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Int32)

Записывает текстовое представление 32-разрядного знакового целого числа в исходящий поток вместе со всеми необходимыми пробелами табуляции.

public:
 override void Write(int value);

public override void Write (int value);

override this.Write : int -> unit

Public Overrides Sub Write (value As Integer)

Параметры

value

Int32

32-разрядное целое число со знаком для записи в исходящий поток.

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Int64)

Записывает текстовое представление 64-разрядного целого числа со знаком в исходящий поток вместе со всеми необходимыми пробелами табуляции.

public:
 override void Write(long value);

public override void Write (long value);

override this.Write : int64 -> unit

Public Overrides Sub Write (value As Long)

Параметры

value

Int64

64-разрядное целое число со знаком для записи в исходящий поток.

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(Object)

Записывает текстовое представление объекта в исходящий поток вместе с любым требуемым пространством табуляции.

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)

Параметры

value

Object

Объект для записи в исходящий поток.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки CultureInfo.CurrentCulture значения свойства .

В этом примере кода создается следующая разметка:

This is a rendered CultureInfo object.

<bold>

Значение CurrentCulture свойства:

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter
• CurrentCulture

Write(Single)

Записывает текстовое представление числа с плавающей запятой (одинарная точность) в исходящий поток вместе с любым требуемым пространством табуляции.

public:
 override void Write(float value);

public override void Write (float value);

override this.Write : single -> unit

Public Overrides Sub Write (value As Single)

Параметры

value

Single

Число с плавающей запятой (одинарная точность) для записи в исходящий поток.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки Single.Epsilon значения поля, которое является наименьшим возможным значением Single структуры.

В этом примере кода создается следующая разметка:

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(String)

Записывает указанную строку в исходящий поток вместе с любым требующимся пространством вкладки.

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)

Параметры

s

String

Строка для записи в исходящий поток.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки строки между открывающим и закрывающим тегами пользовательского элемента разметки.

В этом примере кода создается следующая разметка:

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(String, Object)

Записывает строку табуляции и форматированную строку в исходящий поток с помощью той же семантики, что и метод Format(String, Object) вместе с любым требующимся пространством табуляции.

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)

Параметры

format

String

Строка, содержащая ноль или другие элементы формата.

arg0

Object

Объект для форматирования.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки форматируемой строки со значением CurrentCulture свойства .

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter
• Format(String, Object)
• CurrentCulture

Write(String, Object[])

Записывает форматированную строку, содержащую текстовое представление двух объектов массива в исходящий поток вместе с любым требуемым пространством табуляции. Этот метод использует ту же семантику, что и метод Format(String, Object[]).

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

Параметры

format

String

Строка, содержащая ноль или другие элементы формата.

arg

Object[]

Массив объекта для форматирования.

Примеры

Этот раздел содержит два примера кода. Первый демонстрирует отрисовку форматируемой строки и содержимого массива. Второй демонстрирует объявление массива.

В следующем примере кода показано, как использовать Write метод для отрисовки форматируемой строки и содержимого массива объектов с именем curPriceTime. Вызов метода отрисовывает второй элемент массива перед отрисовки первого элемента.

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

В следующем примере кода показано объявление массива curPriceTime объектов .

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

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter
• Format(String, Object[])

Write(Char[], Int32, Int32)

Записывает текстовое представление подмассива символов в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.

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)

Параметры

buffer

Char[]

Массив символов для записи текста в исходящий поток.

index

Int32

Расположение индекса в массиве откуда начинается запись.

count

Int32

Количество символов для записи в исходящий поток.

Примеры

В этом разделе приведены два примера кода. Первый демонстрирует создание массива символов. Второй демонстрирует использование массива.

В этих примерах кода создается следующая разметка:

<label>

hello

</label>

В следующем примере кода показано, как создать массив символов с описанием hello world. В массив входит SpaceChar поле, которое создает пробел между двумя словами.

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}

В следующей части примера кода используются index параметры Write и count метода для отрисовки первых пяти символов массива, созданного в предыдущем примере.

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

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter

Write(String, Object, Object)

Записывает форматированную строку, содержащую текстовое представление двух объектов в исходящий поток вместе с любым требуемым пространством табуляции. Этот метод использует ту же семантику, что и метод Format(String, Object, Object).

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)

Параметры

format

String

Строка, содержащая ноль или другие элементы формата.

arg0

Object

Объект для форматирования.

arg1

Object

Объект для форматирования.

Примеры

В следующем примере кода показано, как использовать Write метод для отрисовки форматируемой строки и значений CurrentCulture свойств и 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()

Комментарии

Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.

См. также раздел

• TextWriter
• Format(String, Object, Object)
• CurrentCulture