LinkButton.AddParsedSubObject メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LinkButton.AddParsedSubObject メソッド

コントロールに、XML または HTML の要素が解析されたことを通知し、その要素をコントロールの ControlCollection オブジェクトに追加します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overrides Sub
 AddParsedSubObject ( _
    obj As Object _
)

Visual Basic (使用法)

Dim obj As Object

Me.AddParsedSubObject(obj)

protected override void AddParsedSubObject
 (
    Object obj
)

C++

protected:
virtual void AddParsedSubObject (
    Object^ obj
) override

protected void AddParsedSubObject (
    Object obj
)

JScript

protected override function AddParsedSubObject
 (
    obj : Object
)

パラメータ

obj: 解析された要素を表す Object。

使用例

カスタム LinkButton サーバーコントロールの AddParsedSubObject メソッドをオーバーライドして、解析されたオブジェクトが Literal オブジェクトの場合は、テキストプロパティを解析されたオブジェクトのテキストプロパティに設定し、それ以外の場合は空の文字列に設定する方法を次のコード例に示します。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VS.Controls"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page Language="VB" AutoEventWireup="True"
 %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - AddParsedSubObject - VB.NET Example</title>
        <script runat="server">
            Sub LinkButton1_Command(sender As
 Object, e As CommandEventArgs)
                ' Redirect to the Microsoft home page.
                Response.Redirect("http://www.microsoft.com/")
            End Sub
        </script>
    </HEAD>
    <body>
        <form id="Form1" method="post"
 runat="server">
            <h3>Custom LinkButton - AddParsedSubObject - VB.NET Example</h3>
            
            <aspSample:CustomLinkButtonAddParsedSubObject id="LinkButton1"
 
             runat="server" OnCommand="LinkButton1_Command"
 
             ToolTip="Microsoft Home">Microsoft
 Corp.</aspSample:CustomLinkButtonAddParsedSubObject>

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br
 />    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)>
 _
    Public NotInheritable Class
 CustomLinkButtonAddParsedSubObject
        Inherits System.Web.UI.WebControls.LinkButton

        Protected Overrides Sub
 AddParsedSubObject(ByVal obj As Object)

            ' If the server control contains any child controls.
            If Me.HasControls() Then

                ' Notify the base server control that an element, either
 XML or HTML, 
                ' was parsed, and adds the element to the server control's
 
                ' ControlCollection object.
                MyBase.AddParsedSubObject(obj)
                ' Else the server control doesn't contain any child
 controls.
            Else
                ' If the parsed element is a LiteralControl.
                If TypeOf obj Is
 System.Web.UI.LiteralControl Then

                    ' Set the server control's Text property to the
 parsed element's Text value.
                    Me.Text = CType(obj, System.Web.UI.LiteralControl).Text

                    ' Else the parsed element is not a LiteralControl.
                Else
                    ' If the server control has a value in the the Text
 property.
                    Dim currentText As String
 = Me.Text
                    If currentText.Length <> 0 Then

                        ' Set the server control's Text property to
 an empty string.
                        Me.Text = System.String.Empty

                        ' Notify the base server control that a new
 LiteralControl was parsed, 
                        ' and adds the element to the server control's
 ControlCollection object.
                        MyBase.AddParsedSubObject(New
 System.Web.UI.LiteralControl(currentText))
                    End If
                    MyBase.AddParsedSubObject(obj)
                End If
            End If
        End Sub
    End Class

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls"
 Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - AddParsedSubObject - C# Example</title>
    <script runat="server">
      void LinkButton1_Command(Object sender, CommandEventArgs
 e) 
      {
        // Redirect to the Microsoft home page.
        Response.Redirect("http://www.microsoft.com/");
      }
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - AddParsedSubObject - C# Example</h3>
            
            <aspSample:CustomLinkButtonAddParsedSubObject 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonAddParsedSubObject>

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br />using
 System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomLinkButtonAddParsedSubObject
 : System.Web.UI.WebControls.LinkButton
    {
        protected override void AddParsedSubObject(object
 obj)
        {
            // If the server control contains any child controls.
            if (this.HasControls()) 
            {
                // Notify the base server control that an element, either
 XML or HTML, 
                // was parsed, and adds the element to the server control's
 
                // ControlCollection object.
                base.AddParsedSubObject(obj);
            }
            else // Else the server control doesn't
 contain any child controls.
            {
                // If the parsed element is a LiteralControl.
                if (obj is System.Web.UI.LiteralControl) 
                {
                    // Set the server control's Text property to the
 parsed element's Text value.
                    this.Text = ((System.Web.UI.LiteralControl)obj).Text;
                }
                else // Else the parsed element is
 not a LiteralControl.
                {
                    // If the server control has a value in the the
 Text property.
                    string currentText = this.Text;
                    if (currentText.Length != 0) 
                    {
                        // Set the server control's Text property to
 an empty string.
                        this.Text = System.String.Empty;

                        // Notify the base server control that a new
 LiteralControl was parsed, 
                        // and adds the element to the server control's
 ControlCollection object.
                        base.AddParsedSubObject(new
 System.Web.UI.LiteralControl(currentText));
                    }
                    base.AddParsedSubObject(obj);
                }
            }
        }
    }
}

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls"
 Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - AddParsedSubObject - VJ# Example</title>
    <script runat="server">
        void LinkButton1_Command(Object sender, CommandEventArgs
 e) 
        {
            // Redirect to the Microsoft home page.
            get_Response().Redirect("http://www.microsoft.com/");
        } //LinkButton1_Command
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - AddParsedSubObject - VJ# Example</h3>
            
            <aspSample:CustomLinkButtonAddParsedSubObject 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonAddParsedSubObject>

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br />package
 Samples.AspNet.JSL.Controls; 

public class CustomLinkButtonAddParsedSubObject
    extends System.Web.UI.WebControls.LinkButton
{
    protected void AddParsedSubObject(Object
 obj)
    {
        // If the server control contains any child controls.
        if (this.HasControls()) {
            // Notify the base server control that an element, 
            // either XML or HTML, 
            // was parsed, and adds the element to the server control's
 
            // ControlCollection object.
            super.AddParsedSubObject(obj);
        }
        // Else the server control doesn't contain any child controls.
        else {
            // If the parsed element is a LiteralControl.
            if (obj instanceof System.Web.UI.LiteralControl) {
                // Set the server control's Text property to the parsed
 
                // element's Text value.
                this.set_Text(((System.Web.UI.LiteralControl)obj).get_Text());
            }
            // Else the parsed element is not a LiteralControl.
            else {
                // If the server control has a value in the the Text
 property.
                String currentText = this.get_Text();
                if (currentText.get_Length() != 0) {
                    // Set the server control's Text property to an
 
                    // empty string.
                    this.set_Text("");
                    // Notify the base server control that a new 
                    // LiteralControl was parsed, and adds the element
 to 
                    // the server control's ControlCollection object.
                    super.AddParsedSubObject(new System.Web.UI.
                        LiteralControl(currentText));
                }
                super.AddParsedSubObject(obj);
            }
        }
    } //AddParsedSubObject
} //CustomLinkButtonAddParsedSubObject