HtmlTextWriter クラス
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マークアップ文字とテキストを ASP.NET サーバー コントロールの出力ストリームに書き込みます。 このクラスは、クライアントにマークアップをレンダリングするときにサーバー コントロール ASP.NET 使用する書式設定機能を提供します。
public ref class HtmlTextWriter : System::IO::TextWriter
public class HtmlTextWriter : System.IO.TextWriter
type HtmlTextWriter = class
inherit TextWriter
Public Class HtmlTextWriter
Inherits TextWriter
- 継承
- 派生
次のコード例は、Control クラスから派生したカスタム コントロールの Render メソッドをオーバーライドする方法を示しています。 このコード例では、さまざまな HtmlTextWriter メソッド、プロパティ、フィールドを使用する方法を示します。
// Overrides the Render method to write a <span> element
// that applies styles and attributes.
protected override void Render(HtmlTextWriter writer)
{
// Set attributes and values along with attributes and styles
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the
// <span> element.
writer.WriteLine();
writer.Indent++;
writer.Write("Hello");
writer.WriteLine();
// Controls the encoding of markup attributes
// for an <img> element. 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();
// Create a non-standard markup element.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();
// 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");
writer.WriteLine();
writer.Indent--;
writer.RenderEndTag();
}
' Overrides the Render method to write a <span> element
' that applies styles and attributes.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)
' Create a space and indent the markup inside the
' <span> element.
writer.WriteLine()
writer.Indent += 1
writer.Write("Hello")
writer.WriteLine()
' Controls the encoding of markup attributes
' for an <img> element. 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()
' Create a non-standard markup element.
writer.RenderBeginTag("Mytag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()
' 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")
writer.WriteLine()
writer.Indent -= 1
writer.RenderEndTag()
End Sub
HtmlTextWriter クラスは、HTML 4.0 をデスクトップ ブラウザーにレンダリングするために使用されます。 HtmlTextWriter は、ChtmlTextWriter、Html32TextWriter、XhtmlTextWriter クラスなど、System.Web.UI 名前空間内のすべてのマークアップ ライターの基本クラスでもあります。 これらのクラスは、さまざまな種類のマークアップの要素、属性、およびスタイルとレイアウトの情報を記述するために使用されます。 さらに、これらのクラスは、各マークアップ言語に関連付けられているページ およびコントロール アダプター クラスによって使用されます。
ほとんどの状況では、ASP.NET は要求するデバイスに適したライターを自動的に使用します。 ただし、カスタム テキスト ライターを作成する場合、または特定のデバイスのページをレンダリングする特定のライターを指定する場合は、アプリケーション .browser ファイルの controlAdapters
セクションのページにライターをマップする必要があります。
Html |
既定のタブ文字列を使用する HtmlTextWriter クラスの新しいインスタンスを初期化します。 |
Html |
指定したタブ文字列文字を使用して、HtmlTextWriter クラスの新しいインスタンスを初期化します。 |
Core |
この |
Default |
1 つのタブ文字を表します。 |
Double |
引用符 (") 文字を表します。 |
End |
マークアップ要素の終了タグの左山かっことスラッシュ (</) を表します。 |
Equals |
等号 ( |
Equals |
等号 (=) と二重引用符 (") を文字列 (=") で一緒に表します。 |
Self |
マークアップ タグのスペースと自己終了スラッシュ (/) を表します。 |
Self |
自己終了マークアップ要素の終了スラッシュと右山かっこ (/>) を表します。 |
Semicolon |
セミコロン (;)を表します。 |
Single |
アポストロフィ (') を表します。 |
Slash |
スラッシュ (/) を表します。 |
Space |
スペース ( ) 文字を表します。 |
Style |
値と等しいスタイル属性を設定するために使用されるスタイルと等しい ( |
Tag |
マークアップ タグの開始山かっこ (<) を表します。 |
Tag |
マークアップ タグの終了山かっこ (>) を表します。 |
Encoding |
HtmlTextWriter オブジェクトがページにコンテンツを書き込むのに使用するエンコードを取得します。 |
Format |
書式設定を制御するオブジェクトを取得します。 (継承元 TextWriter) |
Indent |
マークアップの各行の先頭をインデントするタブ位置の数を取得または設定します。 |
Inner |
マークアップ要素の内部コンテンツを書き込むテキスト ライターを取得または設定します。 |
New |
HtmlTextWriter オブジェクトで使用される行ターミネータ文字列を取得または設定します。 |
Tag |
指定したマークアップ要素の HtmlTextWriterTag 値を取得または設定します。 |
Tag |
レンダリングされるマークアップ要素のタグ名を取得または設定します。 |
Add |
RenderBeginTag メソッドの後続の呼び出しで、HtmlTextWriter オブジェクトが作成する要素の開始タグにマークアップ属性と属性値を追加します。 |
Add |
マークアップ属性と属性値を、HtmlTextWriter オブジェクトが後で RenderBeginTag メソッドを呼び出して作成する要素の開始タグに追加します (省略可能なエンコード)。 |
Add |
RenderBeginTag メソッドの後続の呼び出しで、HtmlTextWriter オブジェクトが作成する要素の開始タグに、指定したマークアップ属性と値を追加します。 |
Add |
HtmlTextWriter オブジェクトが後で RenderBeginTag メソッドを呼び出して作成する要素の開始タグに、指定したマークアップ属性と値を追加します (省略可能なエンコード)。 |
Add |
指定したマークアップ属性と値を、HtmlTextWriterAttribute 列挙値と共に、HtmlTextWriter オブジェクトが作成する要素の開始タグに追加し、後続の RenderBeginTag メソッドの呼び出しを行います。 |
Add |
指定した HtmlTextWriterStyle 値に関連付けられたマークアップ スタイル属性と属性値を、後続の RenderBeginTag メソッドの呼び出しによって作成された開始マークアップ タグに追加します。 |
Add |
指定したマークアップ スタイル属性と属性値を、後続の RenderBeginTag メソッドの呼び出しによって作成された開始マークアップ タグに追加します。 |
Add |
指定したマークアップ スタイル属性と属性値を、HtmlTextWriterStyle 列挙値と共に、RenderBeginTag メソッドの後続の呼び出しによって作成された開始マークアップ タグに追加します。 |
Begin |
HtmlTextWriter オブジェクトまたは派生クラスのオブジェクトに、コントロールがレンダリングされようとしていることを通知します。 |
Close() |
HtmlTextWriter オブジェクトを閉じ、それに関連付けられているシステム リソースを解放します。 |
Create |
リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject) |
Dispose() |
TextWriter オブジェクトによって使用されるすべてのリソースを解放します。 (継承元 TextWriter) |
Dispose(Boolean) |
TextWriter によって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。 (継承元 TextWriter) |
Dispose |
TextWriter オブジェクトによって使用されるすべてのリソースを非同期的に解放します。 (継承元 TextWriter) |
Encode |
現在のコンテキストの HttpRequest オブジェクトの要件に基づいて、指定したマークアップ属性の値をエンコードします。 |
Encode |
現在のコンテキストの HttpRequest オブジェクトの要件に基づいて、指定したマークアップ属性の値をエンコードします。 |
Encode |
指定した URL 内のスペースを文字列 "%20" に変換することで、最小限の URL エンコードを実行します。 |
End |
コントロールのレンダリングが完了したことを、HtmlTextWriter オブジェクトまたは派生クラスのオブジェクトに通知します。 このメソッドを使用すると、BeginRender() メソッドで開かれたマークアップ要素を閉じます。 |
Enter |
指定したスタイルのレイアウトと文字書式を実装する属性を含む |
Enter |
指定したスタイルのレイアウトと文字書式を実装する属性を含むマークアップ要素の開始タグを書き込みます。 |
Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
Exit |
指定したレイアウトと文字の書式設定を終了するために、 |
Exit |
指定したレイアウトと文字の書式設定を終了するために、指定したマークアップ要素の終了タグを書き込みます。 |
Filter |
ページまたは Web サーバー コントロールのすべてのプロパティのすべてのマークアップ属性とスタイル属性を削除します。 |
Flush() |
現在の HtmlTextWriter オブジェクトのすべてのバッファーをクリアし、バッファー内のデータを出力ストリームに書き込みます。 |
Flush |
現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (継承元 TextWriter) |
Flush |
現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (継承元 TextWriter) |
Get |
指定した属性の対応する HtmlTextWriterAttribute 列挙値を取得します。 |
Get |
指定した HtmlTextWriterAttribute 値に関連付けられているマークアップ属性の名前を取得します。 |
Get |
既定のハッシュ関数として機能します。 (継承元 Object) |
Get |
古い.
このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
Get |
指定したスタイルの HtmlTextWriterStyle 列挙値を取得します。 |
Get |
指定した HtmlTextWriterStyle 列挙値に関連付けられているマークアップ スタイル属性名を取得します。 |
Get |
指定したマークアップ要素に関連付けられている HtmlTextWriterTag 列挙値を取得します。 |
Get |
指定した HtmlTextWriterTag 列挙値に関連付けられているマークアップ要素を取得します。 |
Get |
現在のインスタンスの Type を取得します。 (継承元 Object) |
Initialize |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
Is |
RenderBeginTag メソッドの次の呼び出し中に、指定したマークアップ属性とその値をレンダリングするかどうかを決定します。 |
Is |
RenderBeginTag メソッドの次の呼び出し中に、指定したマークアップ属性とその値をレンダリングするかどうかを決定します。 |
Is |
RenderBeginTag メソッドの次の呼び出し中に、指定したマークアップ スタイル属性をレンダリングするかどうかを決定します。 |
Is |
RenderBeginTag メソッドの次の呼び出し中に、指定したマークアップ スタイル属性とその値をレンダリングするかどうかを決定します。 |
Is |
属性をチェックして、 |
Memberwise |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
Memberwise |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
On |
指定したマークアップ属性とその値を現在のマークアップ要素にレンダリングできるかどうかを判断します。 |
On |
指定したマークアップ スタイル属性とその値を現在のマークアップ要素にレンダリングできるかどうかを判断します。 |
On |
指定したマークアップ要素を要求ページにレンダリングするかどうかを決定します。 |
Output |
マークアップ文字の行のインデント レベルを表す一連のタブ文字列を書き込みます。 |
Pop |
レンダリングされた要素の一覧から、最後に保存したマークアップ要素を削除します。 |
Push |
マークアップ要素の終了タグを生成するときに後で使用するために、指定したマークアップ要素を保存します。 |
Register |
要求元のクライアントに適切にレンダリングできるように、ソース ファイルからマークアップ属性を登録します (リテラルまたは動的に生成されるかどうか)。 |
Register |
リテラルまたは動的に生成されたマークアップ スタイルプロパティをソース ファイルから登録し、要求元のクライアントに適切にレンダリングできるようにします。 |
Register |
要求元のクライアントに適切にレンダリングできるように、ソース ファイルからマークアップ タグを登録します (リテラルか動的に生成されるか)。 |
Render |
コンテンツの後、およびマークアップ要素の終了タグの前に発生するテキストまたは間隔をマークアップ出力ストリームに書き込みます。 |
Render |
マークアップ要素の終了タグの後に発生する間隔またはテキストを書き込みます。 |
Render |
コンテンツの前とマークアップ要素の開始タグの後に、任意のテキストまたは間隔を書き込みます。 |
Render |
マークアップ要素の開始タグの前に発生するテキストまたは間隔を書き込みます。 |
Render |
指定した HtmlTextWriterTag 列挙値に関連付けられたマークアップ要素の開始タグを出力ストリームに書き込みます。 |
Render |
指定したマークアップ要素の開始タグを出力ストリームに書き込みます。 |
Render |
マークアップ要素の終了タグを出力ストリームに書き込みます。 |
To |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
Write(Boolean) |
ブール値のテキスト表現を、保留中のタブ間隔と共に出力ストリームに書き込みます。 |
Write(Char) |
保留中のタブ間隔と共に、Unicode 文字のテキスト表現を出力ストリームに書き込みます。 |
Write(Char[]) |
Unicode 文字の配列のテキスト表現を、保留中のタブ間隔と共に出力ストリームに書き込みます。 |
Write(Char[], Int32, Int32) |
Unicode 文字のサブ配列のテキスト表現を、保留中のタブ間隔と共に出力ストリームに書き込みます。 |
Write(Decimal) |
10 進値のテキスト表現をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write(Double) |
倍精度浮動小数点数のテキスト表現を、保留中のタブ間隔と共に出力ストリームに書き込みます。 |
Write(Int32) |
保留中のタブ間隔と共に、32 バイト符号付き整数のテキスト表現を出力ストリームに書き込みます。 |
Write(Int64) |
保留中のタブ間隔と共に、64 バイト符号付き整数のテキスト表現を出力ストリームに書き込みます。 |
Write(Object) |
保留中のタブ間隔と共に、オブジェクトのテキスト表現を出力ストリームに書き込みます。 |
Write(Read |
テキスト ストリームに文字スパンを書き込みます。 (継承元 TextWriter) |
Write(Single) |
単精度浮動小数点数のテキスト表現を、保留中のタブ間隔と共に出力ストリームに書き込みます。 |
Write(String) |
保留中のタブ間隔と共に、指定した文字列を出力ストリームに書き込みます。 |
Write(String, Object) |
保留中のタブ間隔と共に、Format(String, Object) メソッドと同じセマンティクスを使用して、タブ文字列と書式設定された文字列を出力ストリームに書き込みます。 |
Write(String, Object, Object) |
保留中のタブ間隔と共に、2 つのオブジェクトのテキスト表現を含む書式設定された文字列を出力ストリームに書き込みます。 このメソッドは、Format(String, Object, Object) メソッドと同じセマンティクスを使用します。 |
Write(String, Object, Object, Object) |
Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write(String, Object[]) |
保留中のタブ間隔と共に、オブジェクト配列のテキスト表現を含む書式設定された文字列を出力ストリームに書き込みます。 このメソッドは、Format(String, Object[]) メソッドと同じセマンティクスを使用します。 |
Write(String, Read |
Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write(String |
文字列ビルダーをテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write(UInt32) |
4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write(UInt64) |
8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write |
文字をテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
文字配列をテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
文字のサブ配列をテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
文字メモリ領域をテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
文字列をテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
文字列ビルダーをテキスト ストリームに非同期的に書き込みます。 (継承元 TextWriter) |
Write |
指定したマークアップ属性と値を出力ストリームに書き込みます。 |
Write |
指定したマークアップ属性と値を出力ストリームに書き込み、指定した場合はエンコードされた値を書き込みます。 |
Write |
指定したマークアップ要素のタブ間隔と開始タグを出力ストリームに書き込みます。 |
Write |
|
Write |
要求するデバイスの指定されたテキストをエンコードし、出力ストリームに書き込みます。 |
Write |
指定した URL をエンコードし、出力ストリームに書き込みます。 URL にはパラメーターが含まれる場合があります。 |
Write |
要求するデバイスの指定された URL パラメーターをエンコードし、出力ストリームに書き込みます。 |
Write |
指定したマークアップ要素のタブ間隔と終了タグを書き込みます。 |
Write |
指定したマークアップ要素のタブ間隔と開始タグを出力ストリームに書き込みます。 |
Write |
行ターミネータ文字列を出力ストリームに書き込みます。 |
Write |
保留中のタブ間隔とブール値のテキスト表現を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 |
Write |
保留中のタブ間隔と Unicode 文字の後に行ターミネータ文字列を出力ストリームに書き込みます。 |
Write |
保留中のタブ間隔と Unicode 文字の配列を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 |
Write |
保留中のタブ間隔と Unicode 文字のサブ配列の後に行ターミネータ文字列を出力ストリームに書き込みます。 |
Write |
10 進値のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
保留中のタブ間隔と倍精度浮動小数点数のテキスト表現を出力ストリームに書き込み、続けて行終端記号文字列を書き込みます。 |
Write |
保留中のタブ間隔と、32 バイト符号付き整数のテキスト表現と行終端文字列を出力ストリームに書き込みます。 |
Write |
保留中のタブ間隔と、64 バイト符号付き整数のテキスト表現と行終端文字列を出力ストリームに書き込みます。 |
Write |
保留中のタブ間隔と、オブジェクトのテキスト表現を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 |
Write |
文字範囲のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
保留中のタブ間隔と、単精度浮動小数点数のテキスト表現を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 |
Write |
保留中のタブ間隔とテキスト文字列を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 |
Write |
保留中のタブ間隔と、オブジェクトのテキスト表現を含む書式設定された文字列を出力ストリームに書き込みます。 |
Write |
保留中のタブ間隔と、2 つのオブジェクトのテキスト表現を含む書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。 |
Write |
Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write |
保留中のタブ間隔と、オブジェクト配列のテキスト表現を含む書式設定された文字列を出力ストリームに書き込み、続けて行終端文字列を書き込みます。 |
Write |
Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。 (継承元 TextWriter) |
Write |
文字列ビルダーのテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
保留中のタブ間隔と 4 バイト符号なし整数のテキスト表現を出力ストリームに書き込み、続けて行終端文字列を書き込みます。 |
Write |
8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
テキスト ストリームに行ターミネータを非同期に書き込みます。 (継承元 TextWriter) |
Write |
テキスト ストリームに文字を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
テキスト ストリームに文字の配列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
テキスト ストリームに文字のサブ配列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
文字メモリ領域のテキスト表現をテキスト ストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
テキスト ストリームに文字列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
文字列ビルダーのテキスト表現をテキスト ストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter) |
Write |
文字列を出力ストリームに書き込み、続けて行ターミネータ文字列を書き込みます。 このメソッドは、指定したタブ間隔を無視します。 |
Write |
指定したスタイル属性を出力ストリームに書き込みます。 |
Write |
指定したスタイルの属性と値を出力ストリームに書き込み、指定されている場合は値をエンコードします。 |
Write |
指定した文字列を URL 要件に従ってエンコードして書き込みます。 |
IDisposable. |
このメンバーの説明については、Dispose()を参照してください。 (継承元 TextWriter) |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。