Page.AddOnPreRenderCompleteAsync Methode

Definitie

Naamruimte:: System.Web.UI

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Registreert de gedelegeerden van de begin- en eindgebeurtenishandler voor een asynchrone pagina.

Overloads

Name	Description
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)	Registreert begin- en eindgebeurtenishandler gedelegeerden waarvoor geen statusinformatie is vereist voor een asynchrone pagina.
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)	Registreert de gedelegeerden van de begin- en eindgebeurtenishandler voor een asynchrone pagina.

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)

Registreert begin- en eindgebeurtenishandler gedelegeerden waarvoor geen statusinformatie is vereist voor een asynchrone pagina.

public:
 void AddOnPreRenderCompleteAsync(System::Web::BeginEventHandler ^ beginHandler, System::Web::EndEventHandler ^ endHandler);

public void AddOnPreRenderCompleteAsync(System.Web.BeginEventHandler beginHandler, System.Web.EndEventHandler endHandler);

member this.AddOnPreRenderCompleteAsync : System.Web.BeginEventHandler * System.Web.EndEventHandler -> unit

Public Sub AddOnPreRenderCompleteAsync (beginHandler As BeginEventHandler, endHandler As EndEventHandler)

Parameters

beginHandler: BeginEventHandler

De gemachtigde voor de BeginEventHandler methode.

endHandler: EndEventHandler

De gemachtigde voor de EndEventHandler methode.

Uitzonderingen

InvalidOperationException

De <async> pagina-instructie is niet ingesteld op true.

– of –

De AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler) methode wordt aangeroepen na de PreRender gebeurtenis.

ArgumentNullException

De BeginHandler of EndHandler is null.

Voorbeelden

In het volgende codevoorbeeld wordt een asynchrone aanvraag gebruikt om de HTML-broncode van de standaardpagina van de lokale webserver in een TextBox besturingselement weer te geven.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

<%@ page language="C#" Async="true"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  System.Net.WebRequest myRequest;

  void Page_Load(object sender, EventArgs e)
  {
    Label1.Text = "Page_Load: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();

    BeginEventHandler bh = new BeginEventHandler(this.BeginGetAsyncData);
    EndEventHandler eh = new EndEventHandler(this.EndGetAsyncData);

    AddOnPreRenderCompleteAsync(bh, eh);

    // Initialize the WebRequest.
    string address = "http://localhost/";

    myRequest = System.Net.WebRequest.Create(address);
  }

  IAsyncResult BeginGetAsyncData(Object src, EventArgs args, AsyncCallback cb, Object state)
  {
    Label2.Text = "BeginGetAsyncData: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();
    return myRequest.BeginGetResponse(cb, state);
  }

  void EndGetAsyncData(IAsyncResult ar)
  {
    Label3.Text = "EndGetAsyncData: thread #" + System.Threading.Thread.CurrentThread.GetHashCode();

    System.Net.WebResponse myResponse = myRequest.EndGetResponse(ar);

    result.Text = new System.IO.StreamReader(myResponse.GetResponseStream()).ReadToEnd();
    myResponse.Close();
  }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      Page.AddOnPreRenderCompleteAsync Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:label id="Label1" runat="server">
        Label 1</asp:label><br />
      <asp:label id="Label2" runat="server">
        Label 2</asp:label><br />
      <asp:label id="Label3" runat="server">
        Label 3</asp:label><br />
      <asp:textbox id="result" runat="server" textMode="multiLine" ReadOnly="true" columns="80" rows="25" />
    </form>
  </body>
</html>

<%@ page language="VB" Async="true"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  Dim myRequest As System.Net.WebRequest
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "Page_Load: Thread #" & System.Threading.Thread.CurrentThread.GetHashCode()
    
    Dim bh As New BeginEventHandler(AddressOf Me.BeginGetAsyncData)
    Dim eh As New EndEventHandler(AddressOf Me.EndGetAsyncData)
    
    Me.AddOnPreRenderCompleteAsync(bh, eh)
    
    ' Initialize the WebRequest object.
    Dim address As String
    address = "http://localhost/"
    myRequest = System.Net.WebRequest.Create(address)
    
  End Sub
  
  Function BeginGetAsyncData(ByVal src As Object, ByVal args As EventArgs, ByVal cb As AsyncCallback, ByVal state As Object) As IAsyncResult
    Label2.Text = "BeginGetAsyncData: Thread #" & System.Threading.Thread.CurrentThread.GetHashCode()
    Return Me.myRequest.BeginGetResponse(cb, state)
  End Function
  
  Sub EndGetAsyncData(ByVal ar As IAsyncResult)
    Label3.Text = "EndGetAsyncData: Thread #" & System.Threading.Thread.CurrentThread.GetHashCode()
    
    Dim myResponse As System.Net.WebResponse
    myResponse = Me.myRequest.EndGetResponse(ar)
    
    Dim reader As New System.IO.StreamReader(myResponse.GetResponseStream())
    result.Text = reader.ReadToEnd()
    myResponse.Close()
  End Sub
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      Page.AddOnPreRenderCompleteAsync Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:label id="Label1" runat="server">
        Label 1</asp:label><br />
      <asp:label id="Label2" runat="server">
        Label 2</asp:label><br />
      <asp:label id="Label3" runat="server">
        Label 3</asp:label><br />
      <asp:textbox id="result" runat="server" textMode="multiLine" ReadOnly="true" columns="80" rows="25" />
    </form>
  </body>
</html>

Opmerkingen

Gebruik de AddOnPreRenderCompleteAsync methode om handlers toe te voegen aan een asynchrone webpagina.

U kunt meerdere asynchrone handlers registreren; er wordt echter slechts één handler tegelijk uitgevoerd. Als u meerdere asynchrone methoden tegelijk wilt verwerken, moet u één BeginEventHandler methode gebruiken en meerdere asynchrone bewerkingen vanuit die handler starten.

De asynchrone handlers worden tussen de PreRender en PreRenderComplete gebeurtenissen aangeroepen.

Eerst worden alle Page gebeurtenissen (via de PreRender gebeurtenis) uitgevoerd en vervolgens wordt elke geregistreerde BeginEventHandler methode aangeroepen. Wanneer de handler is voltooid, wordt de bijbehorende EndEventHandler methode aangeroepen. Als er meerdere asynchrone handlers zijn, wordt de volgende handler aangeroepen.

Nadat de geregistreerde asynchrone gebeurtenis-handlers zijn aangeroepen, worden de rest van de paginagebeurtenissen aangeroepen, te beginnen met de PreRenderComplete gebeurtenis.

Zie ook

Van toepassing op

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)