XhtmlTextWriter.IsValidFormAttribute(String) XhtmlTextWriter.IsValidFormAttribute(String) XhtmlTextWriter.IsValidFormAttribute(String) XhtmlTextWriter.IsValidFormAttribute(String) Method

定義

XHTML 属性をチェックして、<form> 要素の開始タグにその XHTML 属性をレンダリングできるかどうかを確認します。Checks an XHTML attribute to ensure that it can be rendered in the opening tag of a <form> element.

public:
 override bool IsValidFormAttribute(System::String ^ attributeName);
public override bool IsValidFormAttribute (string attributeName);
override this.IsValidFormAttribute : string -> bool
Public Overrides Function IsValidFormAttribute (attributeName As String) As Boolean

パラメーター

attributeName
String String String String

確認対象の属性名。The attribute name to check.

戻り値

属性を true 要素に適用できる場合は <form>。それ以外の場合は falsetrue if the attribute can be applied to a <form> element; otherwise, false.

次のコード例は、カスタムLabelコントロールと、XHTML としてコントロールのコンテンツをレンダリングするアダプターを作成する、より大きな例の一部です。The following code example is part of a larger example that creates a custom Label control and an adapter that renders the content of the control as XHTML.

このコード例では、という名前attTestのブール型変数を作成し、パラメーター値 "style" を指定してIsValidFormAttributeメソッドを呼び出した結果として返される戻り値に設定する方法を示します。This code example demonstrates how to create a Boolean variable named attTest and set it to the return value that results from calling the IsValidFormAttribute method with the parameter value "style". メソッドがIsValidFormAttributeを返すtrue場合、 HtmlTextWriter.EnterStyleコントロールに関連付けられているスタイルは、メソッドHtmlTextWriter.ExitStyleとメソッドを使用して表示されます。If the IsValidFormAttribute method returns true, the styles that are associated with the control are rendered using the HtmlTextWriter.EnterStyle and HtmlTextWriter.ExitStyle methods. attTest値がfalseの場合、スタイルはレンダリングされません。If the attTest value is false, the styles are not rendered. このページには、コントロール<br/>のテキスト、 WriteBreakメソッドによって表示される要素、およびコントロールの XHTML コンテンツが条件付きでレンダリングされたことをユーザーに通知するテキスト文字列が表示されます。Instead, the page displays the text for the control, a <br/> element that is rendered by the WriteBreak method, and a text string informing the user that the XHTML content of the control has rendered conditionally.

このコード例は、 XhtmlTextWriterクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the XhtmlTextWriter class.

protected override void Render(HtmlTextWriter writer)
{
	// Create an instance of the XhtmlTextWriter class,
	// named w, and cast the HtmlTextWriter passed 
	// in the writer parameter to w.
	XhtmlTextWriter w = new XhtmlTextWriter(writer);

	// Create a string variable, named value, to hold
	// the control's Text property value.
	String value = Control.Text;

	
          // Create a Boolean variable, named attTest,
          // to test whether the Style attribute is 
          // valid in the page that the control is
          // rendered to.
          Boolean attTest = w.IsValidFormAttribute("style");

          // Check whether attTest is true or false.
          // If true, a style is applied to the XHTML
          // content. If false, no style is applied.
	if (attTest)
		w.EnterStyle(Control.ControlStyle);

	// Write the Text property value of the control,
          // a <br> element, and a string. Consider encoding the value using WriteEncodedText.
          w.Write(value);
          w.WriteBreak();
          w.Write("This control conditionally rendered its styles for XHTML.");

          // Check whether attTest is true or false.
          // If true, the XHTML style is closed.
          // If false, nothing is rendered.
          if (attTest)
              w.ExitStyle(Control.ControlStyle);
}
' Override the Render method.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

    ' Create an instance of the XhtmlTextWriter class, 
    ' named w, and cast the HtmlTextWriter passed 
    ' in the writer parameter to w.
    Dim w As XhtmlTextWriter = New XhtmlTextWriter(writer)

    ' Create a string variable, named value, to hold
    ' the control's Text property value.
    Dim value As String = Control.Text

    ' Create a Boolean variable, named attTest,
    ' to test whether the Style attribute is 
    ' valid in the page that the control is
    ' rendered to.
    Dim attTest As Boolean = w.IsValidFormAttribute("style")

    ' Check whether attTest is true or false.
    ' If true, a style is applied to the XHTML
    ' content. If false, no style is applied.
    If (attTest = True) Then
        w.EnterStyle(Control.ControlStyle)
    End If

    ' Write the Text property value of the control,
    ' a <br> element, and a string. Consider encoding the value using WriteEncodedText.
    w.Write(value)
    w.WriteBreak()
    w.Write("This control conditionally rendered its styles for XHTML.")

    ' Check whether attTest is true or false.
    ' If true, the XHTML style is closed.
    ' If false, nothing is rendered.
    If (attTest = True) Then
        w.ExitStyle(Control.ControlStyle)
    End If

End Sub 'Render

注釈

このメソッドは、要求元のデバイスの XHTML ドキュメントタイプによってサポートされているかどうかに応じて、条件付きで属性を表示する場合に便利です。This method is useful to conditionally render an attribute depending on whether it is supported by the XHTML document type of the requesting device.

適用対象