HtmlTextWriter.WriteLine Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

Записывает данные в выходной HtmlTextWriter поток, как указано перегруженными параметрами, за которым следует строка конца строки. Все версии этого метода записывают все ожидающие интервалы вкладок в выходной поток.

Перегрузки

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

WriteLine(String, Object, Object)

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

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)

Параметры

format

String

Строка, содержащая ноль или больше элементов формата.

arg0

Object

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

arg1

Object

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

Примеры

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Метод WriteLine использует ту же семантику, что Format(String, Object, Object) и метод. Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[], Int32, Int32)

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

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)

Параметры

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 и count параметры WriteLine метода для отрисовки первых пяти символов массива, созданного в предыдущем примере кода.

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object[])

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

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

Параметры

format

String

Строка, содержащая ноль или больше элементов формата.

arg

Object[]

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

Примеры

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

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

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

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

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Метод WriteLine использует ту же семантику, что Format(String, Object[]) и метод. Базовый WriteLine метод используется для записи value метода.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(String, Object)

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

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)

Параметры

format

String

Строка, содержащая ноль или больше элементов формата.

arg0

Object

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

Примеры

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Метод WriteLine использует ту же семантику, что Format(String, Object) и метод. Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(UInt32)

Внимание

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS

System.Web.UI.HtmlTextWriter.WriteLine(Int64)

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

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)

Параметры

value

UInt32

Целое число без знака 4 байта для записи в выходной поток.

Атрибуты

CLSCompliantAttribute

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(String)

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

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)

Параметры

s

String

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Single)

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

public:
 override void WriteLine(float value);

public override void WriteLine(float value);

override this.WriteLine : single -> unit

Public Overrides Sub WriteLine (value As Single)

Параметры

value

Single

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

Примеры

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

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Int32)

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

public:
 override void WriteLine(int value);

public override void WriteLine(int value);

override this.WriteLine : int -> unit

Public Overrides Sub WriteLine (value As Integer)

Параметры

value

Int32

Целое число со знаком 32 байта для записи в выходной поток.

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Int64)

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

public:
 override void WriteLine(long value);

public override void WriteLine(long value);

override this.WriteLine : int64 -> unit

Public Overrides Sub WriteLine (value As Long)

Параметры

value

Int64

Целое число со знаком 64-байтов для записи в выходной поток.

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Double)

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

public:
 override void WriteLine(double value);

public override void WriteLine(double value);

override this.WriteLine : double -> unit

Public Overrides Sub WriteLine (value As Double)

Параметры

value

Double

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

Примеры

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

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Char[])

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

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

Параметры

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}

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Char)

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

public:
 override void WriteLine(char value);

public override void WriteLine(char value);

override this.WriteLine : char -> unit

Public Overrides Sub WriteLine (value As Char)

Параметры

value

Char

Символ для записи в выходной поток.

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Boolean)

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

public:
 override void WriteLine(bool value);

public override void WriteLine(bool value);

override this.WriteLine : bool -> unit

Public Overrides Sub WriteLine (value As Boolean)

Параметры

value

Boolean

Логическое значение для записи в выходной поток.

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine

WriteLine()

Записывает строку конца строки в выходной поток.

public:
 override void WriteLine();

public override void WriteLine();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

Примеры

В следующем примере кода показано, как использовать WriteLine метод для вставки строки после <img> отрисовки элемента.

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Дополнительные сведения см. в разделе WriteLine.

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

• NewLine
• TextWriter
• WriteLine

WriteLine(Object)

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

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)

Параметры

value

Object

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

Примеры

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

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

Комментарии

Строка конца строки по умолчанию — это возврат каретки, за которой следует канал строки ("\r\n"). Базовый WriteLine метод используется для записи value параметра.

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

• NewLine
• TextWriter
• WriteLine