Freigeben über


LinkButton.OnPreRender-Methode

Löst das PreRender-Ereignis aus.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Friend Overrides Sub OnPreRender ( _
    e As EventArgs _
)
'Usage
Dim e As EventArgs

Me.OnPreRender(e)
protected internal override void OnPreRender (
    EventArgs e
)
protected public:
virtual void OnPreRender (
    EventArgs^ e
) override
protected void OnPreRender (
    EventArgs e
)
protected internal override function OnPreRender (
    e : EventArgs
)

Parameter

  • e
    Ein EventArgs-Objekt, das die Ereignisdaten enthält.

Hinweise

Die OnPreRender-Methode benachrichtigt das LinkButton-Steuerelement, damit alle erforderlichen Vorbereitungsschritte für das Rendering vor dem Speichern des Ansichtszustands und dem Rendering des Inhalts auf dem Client ausgeführt werden.

Beispiel

Das folgende Codebeispiel veranschaulicht das Überschreiben der OnPreRender-Methode, sodass ein Rahmen niemals in einem benutzerdefinierten LinkButton-Steuerelement angezeigt wird.

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

        </form>
    </body>
</HTML>

...
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomLinkButtonOnPreRender
        Inherits System.Web.UI.WebControls.LinkButton

        Protected Overrides Sub OnPreRender(ByVal e As System.EventArgs)

            ' Run the OnPreRender method on the base class.
            MyBase.OnPreRender(e)

            ' Always display the LinkButton without a border.
            Me.BorderWidth = System.Web.UI.WebControls.Unit.Point(0)
        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 - OnPreRender - C# Example</title>
    <script runat="server">
      void LinkButton1_Command(Object sender, CommandEventArgs e) 
      {
        // Redirect to the Microsoft home page.
        Response.Redirect("https://www.microsoft.com/");
      }
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - OnPreRender - C# Example</h3>
            
            <aspSample:CustomLinkButtonOnPreRender 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonOnPreRender>
            
        </form>
    </body>
</HTML>

...
using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomLinkButtonOnPreRender : System.Web.UI.WebControls.LinkButton
  {
    protected override void OnPreRender(System.EventArgs e)
    {
      // Run the OnPreRender method on the base class.
      base.OnPreRender(e);

      // Always display the LinkButton without a border.
      this.BorderWidth =  System.Web.UI.WebControls.Unit.Point(0);
    }
  }
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - OnPreRender - VJ# Example</title>
    <script runat="server">
        void LinkButton1_Command(Object sender, CommandEventArgs e) 
        {
            // Redirect to the Microsoft home page.
            get_Response().Redirect("https://www.microsoft.com/");
        } //LinkButton1_Command
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - OnPreRender - VJ# Example</h3>
            
            <aspSample:CustomLinkButtonOnPreRender 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonOnPreRender>
            
        </form>
    </body>
</HTML>

...
package Samples.AspNet.JSL.Controls;
 
public class CustomLinkButtonOnPreRender
    extends System.Web.UI.WebControls.LinkButton
{
    protected void OnPreRender(System.EventArgs e)
    {
        // Run the OnPreRender method on the base class.
        super.OnPreRender(e);
        // Always display the LinkButton without a border.
        this.set_BorderWidth(System.Web.UI.WebControls.Unit.Point(0));
    } //OnPreRender
} //CustomLinkButtonOnPreRender

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

LinkButton-Klasse
LinkButton-Member
System.Web.UI.WebControls-Namespace
PreRender

Weitere Ressourcen

Button-Webserver-Steuerelemente