HtmlTextWriter.WriteLine Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные в исходящий поток 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 байта, записываемое в исходящий поток.
- Атрибуты
Комментарии
Строка конца строки по умолчанию представляет собой возврат каретки, за которым следует канал строки ("\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
параметра .