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 параметра .

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

Применяется к

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

// 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 параметра .

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

Применяется к

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 метода .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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 параметра .

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

Применяется к

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.

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

Применяется к

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 параметра .

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

Применяется к