HtmlTextWriter.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает указанный тип данных в исходящий поток вместе с любым требующимся пространством вкладки.
Перегрузки
| 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 -> unitPublic Overrides Sub Write (value As Boolean)Параметры
Комментарии
Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.
См. также раздел
Применяется к
Write(Char)
Записывает текстовое представление символа в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.
public:
override void Write(char value);public override void Write (char value);override this.Write : char -> unitPublic 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 метод.
См. также раздел
Применяется к
Write(Char[])
Записывает текстовое представление массива символов в кодировке Юникод в исходящий поток вместе с любым требуемым пространством табуляции.
public:
override void Write(cli::array <char> ^ buffer);public override void Write (char[] buffer);override this.Write : char[] -> unitPublic 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 метод.
См. также раздел
Применяется к
Write(Double)
Записывает текстовое представление числа с плавающей запятой в исходящий поток вместе с любым требуемым пространством табуляции.
public:
override void Write(double value);public override void Write (double value);override this.Write : double -> unitPublic 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 метод.
См. также раздел
Применяется к
Write(Int32)
Записывает текстовое представление 32-разрядного знакового целого числа в исходящий поток вместе со всеми необходимыми пробелами табуляции.
public:
override void Write(int value);public override void Write (int value);override this.Write : int -> unitPublic Overrides Sub Write (value As Integer)Параметры
- value
- Int32
32-разрядное целое число со знаком для записи в исходящий поток.
Комментарии
Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.
См. также раздел
Применяется к
Write(Int64)
Записывает текстовое представление 64-разрядного целого числа со знаком в исходящий поток вместе со всеми необходимыми пробелами табуляции.
public:
override void Write(long value);public override void Write (long value);override this.Write : int64 -> unitPublic Overrides Sub Write (value As Long)Параметры
- value
- Int64
64-разрядное целое число со знаком для записи в исходящий поток.
Комментарии
Метод Write создает все ожидающие вкладки, а затем вызывает базовый Write метод.
См. также раздел
Применяется к
Write(Object)
Записывает текстовое представление объекта в исходящий поток вместе с любым требуемым пространством табуляции.
public:
override void Write(System::Object ^ value);public override void Write (object value);override this.Write : obj -> unitPublic 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 метод.
См. также раздел
Применяется к
Write(Single)
Записывает текстовое представление числа с плавающей запятой (одинарная точность) в исходящий поток вместе с любым требуемым пространством табуляции.
public:
override void Write(float value);public override void Write (float value);override this.Write : single -> unitPublic 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 метод.
См. также раздел
Применяется к
Write(String)
Записывает указанную строку в исходящий поток вместе с любым требующимся пространством вкладки.
public:
override void Write(System::String ^ s);public override void Write (string s);override this.Write : string -> unitPublic 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 метод.
См. также раздел
Применяется к
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 -> unitPublic 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 метод.
См. также раздел
Применяется к
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[] -> unitPublic 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 метод.
См. также раздел
Применяется к
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 -> unitPublic 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 метод.
См. также раздел
Применяется к
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 -> unitPublic 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 метод.
См. также раздел
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по