Page.AddOnPreRenderCompleteAsync Metoda

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zaregistruje počáteční a koncové delegáty obslužné rutiny události pro asynchronní stránku.

Přetížení

Name	Description
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)	Zaregistruje počáteční a koncové delegáty obslužné rutiny událostí, které nevyžadují informace o stavu pro asynchronní stránku.
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)	Zaregistruje počáteční a koncové delegáty obslužné rutiny události pro asynchronní stránku.

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)

Zaregistruje počáteční a koncové delegáty obslužné rutiny událostí, které nevyžadují informace o stavu pro asynchronní stránku.

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)

Parametry

beginHandler: BeginEventHandler

Delegát metody BeginEventHandler .

endHandler: EndEventHandler

Delegát metody EndEventHandler .

Výjimky

InvalidOperationException

Direktiva <async> stránky není nastavena na truehodnotu .

nebo

Metoda AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler) se volá po PreRender události.

ArgumentNullException

BeginHandler Nebo EndHandler je null.

Příklady

Následující příklad kódu používá asynchronní požadavek k zobrazení zdrojového kódu HTML výchozí stránky místního webového serveru v ovládacím TextBox prvku.

Important

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

<%@ 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>

Poznámky

AddOnPreRenderCompleteAsync Metoda slouží k přidání obslužných rutin na asynchronní webovou stránku.

Můžete zaregistrovat několik asynchronních obslužných rutin; Ale najednou se spustí jenom jedna obslužná rutina. Pokud chcete zpracovat více asynchronních metod současně, měli byste použít jednu BeginEventHandler metodu a spustit z této obslužné rutiny několik asynchronních operací.

Asynchronní obslužné rutiny se volají mezi událostmi PreRender a PreRenderComplete událostmi.

Nejprve se spustí všechny Page události (prostřednictvím PreRender události) a pak se volá každá zaregistrovaná BeginEventHandler metoda. Po dokončení obslužné rutiny je volána odpovídající EndEventHandler metoda. Pokud existuje více asynchronních obslužných rutin, volá se další obslužná rutina.

Po volání registrovaných asynchronních obslužných rutin událostí se zbývající události stránky volají, počínaje událostí PreRenderComplete .

Viz také

Platí pro

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)