HtmlTextWriter.RenderBeginTag Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает открывающий тег элемента разметки в исходящий поток.
Перегрузки
RenderBeginTag(String) |
Записывает открывающий тег указанного элемента разметки в выходной поток. |
RenderBeginTag(HtmlTextWriterTag) |
Записывает в исходящий поток открывающий тег элемента разметки, связанного с указанным значением перечисления HtmlTextWriterTag. |
RenderBeginTag(String)
Записывает открывающий тег указанного элемента разметки в выходной поток.
public:
virtual void RenderBeginTag(System::String ^ tagName);
public virtual void RenderBeginTag (string tagName);
abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unit
Public Overridable Sub RenderBeginTag (tagName As String)
Параметры
- tagName
- String
Строка, содержащая имя элемента разметки, для которого необходимо выполнить прорисовку открывающего тега.
Примеры
В следующем примере кода показано, как вызвать RenderBeginTag метод в пользовательском элементе управления для отрисовки открывающего тега нестандартного MyTag
элемента. Затем в примере кода вызывается Write метод для отрисовки внутренней разметки, а затем вызывается RenderEndTag метод для закрытия элемента.
В этом примере кода создается следующая разметка:
<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()
Комментарии
RenderBeginTag Используйте переопределение метода, если элемент разметки RenderBeginTag(String) не является одним из HtmlTextWriterTag значений перечисления.
Чтобы создать элемент разметки с помощью RenderBeginTag метода, сначала вызовите AddAttribute методы и AddStyleAttribute методы, чтобы указать атрибуты элементов или атрибуты стиля, которые должны отображаться в открываемом теге элемента. После создания внутренней разметки вызовите RenderEndTag метод для создания закрывающего тега.
См. также раздел
Применяется к
RenderBeginTag(HtmlTextWriterTag)
Записывает в исходящий поток открывающий тег элемента разметки, связанного с указанным значением перечисления HtmlTextWriterTag.
public:
virtual void RenderBeginTag(System::Web::UI::HtmlTextWriterTag tagKey);
public virtual void RenderBeginTag (System.Web.UI.HtmlTextWriterTag tagKey);
abstract member RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
override this.RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
Public Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)
Параметры
- tagKey
- HtmlTextWriterTag
Одно из значений HtmlTextWriterTag, определяющих открывающий тег элемента разметки, предназначенного для визуализации.
Примеры
В следующем примере кода показано, как использовать RenderBeginTag метод для вывода открывающего тега <img>
элемента. Атрибуты, добавляемые в элемент методом AddAttribute , будут находиться в открываемом <img>
теге. Метод RenderEndTag используется для создания закрывающего тега.
В этом примере кода создается следующая разметка:
<img alt="Encoding "Required"" myattribute="No "encoding" required">
</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()
Комментарии
Используйте перегрузку RenderBeginTag RenderBeginTag(HtmlTextWriterTag) метода, если элемент разметки имеет известный тип, который является одним из HtmlTextWriterTag значений перечисления.
Чтобы создать элемент разметки с помощью RenderBeginTag метода, сначала вызовите AddAttribute методы и AddStyleAttribute методы, чтобы указать атрибуты элементов или атрибуты стиля, которые должны отображаться в открываемом теге элемента. После создания внутренней разметки вызовите RenderEndTag метод для создания закрывающего тега.