ScriptManager Osztály

Definíció

Kezeli ASP.NET Ajax-szkripttárakat és szkriptfájlokat, részleges oldalmegjelenítést és ügyfélproxy-osztály létrehozását a web- és alkalmazásszolgáltatásokhoz.

public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
    inherit Control
    interface IPostBackDataHandler
    interface IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Öröklődés
ScriptManager
Attribútumok
Megvalósítás

Példák

Az alábbi példák különböző forgatókönyveket mutatnak be a ScriptManager vezérlőelem használatához.

Partial-Page frissítések engedélyezése

Az alábbi példa bemutatja, hogyan engedélyezheti a részleges oldalfrissítéseket a ScriptManager vezérlő használatával. Ebben a példában egy Calendar és egy DropDownList vezérlő található egy UpdatePanel vezérlőn belül. Alapértelmezés szerint a UpdateMode tulajdonság Alwaysértéke , a tulajdonság ChildrenAsTriggersértéke pedig .true Ezért a panel gyermekvezérlői aszinkron visszavételt okoznak.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
        Calendar1.DayStyle.BackColor = _
        System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
    End Sub

    Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
        SelectedDate.Text = Calendar1.SelectedDate.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

A Partial-Page frissítési hibáinak kezelése és a szkript regisztrálása

Az alábbi példa bemutatja, hogyan biztosíthatja az egyéni hibakezelést a részleges oldalfrissítések során. Ha a részleges oldalfrissítések során hiba történik, alapértelmezés szerint egy JavaScript-üzenetmező jelenik meg. Ez a példa bemutatja, hogyan használható az egyéni hibakezelés az esemény kezelőjének AsyncPostBackError megadásával és az AsyncPostBackErrorMessage eseménykezelő tulajdonságának beállításával. A tulajdonságot úgy is beállíthatja AllowCustomErrorsRedirect , hogy adja meg, hogyan használja a Web.config fájl egyéni hibaszakaszát, ha hiba történik a részleges oldalfrissítések során. Ebben a példában a tulajdonság alapértelmezett értékét használja a AllowCustomErrorsRedirect rendszer. Ez azt jelenti, hogy ha a Web.config fájl tartalmaz egy customErrors elemet, az az elem határozza meg a hibák megjelenítését. További információ: customErrors elem (ASP.NET Beállítások séma).

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        Try
            Dim a As Int32
            a = Int32.Parse(TextBox1.Text)
            Dim b As Int32
            b = Int32.Parse(TextBox2.Text)
            Dim res As Int32 = a / b
            Label1.Text = res.ToString()
        Catch ex As Exception
            If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
                ex.Data("ExtraInfo") = " You can't divide " & _
                  TextBox1.Text & " by " & TextBox2.Text & "."
            End If
            Throw ex
        End Try

    End Sub
    Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
        If (e.Exception.Data("ExtraInfo") <> Nothing) Then
            ScriptManager1.AsyncPostBackErrorMessage = _
               e.Exception.Message & _
               e.Exception.Data("ExtraInfo").ToString()
        Else
            ScriptManager1.AsyncPostBackErrorMessage = _
               "An unspecified error occurred."
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>

            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>

A böngészőben megjelenített dátum és idő globalizálása

Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot, hogy az EnableScriptGlobalization ügyfélszkript megjeleníthesse a kultúraspecifikus dátumot és időt a böngészőben. A példában a Culture@Page direktíva attribútuma a következőre autovan állítva: . Ennek eredményeképpen az aktuális böngészőbeállításokban megadott első nyelv határozza meg a lap kulturális és felhasználói felületi kultúráját. További információ: Hogyan is: A kulturális és felhasználói felületi kultúra beállítása ASP.NET weblap globalizációjához.

<%@ Page Language="C#" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

Megjegyzések

Ebben a témakörben:

Bevezetés

A ScriptManager vezérlő központi szerepet nyújt az Ajax funkcióiban ASP.NET. A vezérlő az összes ASP.NET Ajax-erőforrást kezeli egy lapon. Ez magában foglalja Microsoft Ajax Library-szkriptek letöltését a böngészőbe, valamint a UpdatePanel vezérlők használatával engedélyezett részleges oldalfrissítések koordinálását. A vezérlő emellett a ScriptManager következőket is lehetővé teszi:

  • Részleges oldalfrissítésekkel kompatibilis szkript regisztrálása. A szkript és az alaptár közötti függőségek kezelése érdekében a regisztrált szkriptek az Ajax-kódtár Microsoft után töltődnek be.

  • Adja meg, hogy a rendszer elküldi-e a kiadási vagy hibakeresési szkripteket a böngészőnek.

  • Adjon hozzáférést a webszolgáltatás-metódusokhoz szkriptből, ha webszolgáltatásokat regisztrál a ScriptManager vezérlővel.

  • Hozzáférést biztosíthat ASP.NET hitelesítési, szerepkör- és profilalkalmazás-szolgáltatásokhoz az ügyfélszkriptből úgy, hogy regisztrálja ezeket a szolgáltatásokat a ScriptManager vezérlővel.

  • Engedélyezze az ECMAScript (JavaScript) dátum-, szám- és sztringfüggvényeinek kultúraspecifikus megjelenítését a böngészőben.

  • A vezérlő tulajdonságának ResourceUICultures használatával ScriptReference hozzáférhet a honosítási erőforrásokhoz beágyazott szkriptfájlokhoz vagy különálló szkriptfájlokhoz.

  • Regisztrálja azokat a kiszolgálóvezérlőket, amelyek a vezérlővel implementálják azokat IExtenderControl , IScriptControl hogy az ScriptManager ügyfélösszetevők és -viselkedések által megkövetelt szkriptek renderelhetők.

Partial-Page renderelés

Egy ASP.NET lap részleges renderelésének támogatásához a következő tényezők vezérlik:

A tulajdonság értékét felülbírálhatja futtatáskor EnablePartialRendering a lap eseménye Init alatt vagy előtt. Ha a tulajdonságot a lap eseménye Init után próbálja módosítani, a rendszer kivételt InvalidOperationException jelez.

Ha a részleges oldalmegjelenítés támogatott, a vezérlő rendereli a ScriptManager szkriptet az aszinkron utómunkák és a részleges oldalfrissítések engedélyezéséhez. A frissítendő lap régiói vezérlőkkel vannak kijelölve UpdatePanel . A ScriptManager vezérlő kezeli az aszinkron visszavételeket, és csak a frissíteni kívánt lapterületeket frissíti. A részleges oldalmegjelenítésről további információt Partial-Page Renderelés áttekintése című témakörben talál. A frissítést kiváltó feltételekről további információt az UpdatePanel vezérlő áttekintése című témakörben talál.

A ScriptManager vezérlő használata mesterlapokkal, felhasználói vezérlőkkel és egyéb gyermekösszetevőkkel

Egy lap csak egy ScriptManager vezérlőt tartalmazhat a hierarchiájában. Ha szolgáltatásokat és szkripteket szeretne regisztrálni beágyazott lapokhoz, felhasználói vezérlőkhöz vagy összetevőkhöz, ha a szülőlap már rendelkezik ScriptManager vezérlővel, használja a vezérlőt ScriptManagerProxy . További információ: Az UpdatePanel vezérlő használata mesterlapokkal.

Szkriptkezelés és -regisztráció

A ScriptManager vezérlő lehetővé teszi a lap részeként renderelt szkriptek regisztrálását. A ScriptManager vezérlőregisztrációs módszerek a következő három kategóriába sorolhatók:

  • Olyan regisztrációs módszerek, amelyek garantálják az Ajax-kódtár Microsoft szkriptfüggőségeinek fenntartását.

  • Olyan regisztrációs módszerek, amelyek nem függnek az Ajax-kódtár Microsoft, de kompatibilisek UpdatePanel vezérlőkkel.

  • A vezérlők használatát UpdatePanel támogató regisztrációs módszerek.

Az Ajax-szkriptek ASP.NET való létrehozásáról és használatáról további információt az Ajax-kódtár Microsoft egyéni ügyfélszkriptjének létrehozásával című témakörben talál.

Az Ajax Microsoft-kódtártól függő szkript regisztrálása

Az alábbi módszerekkel olyan módon regisztrálhatja a szkriptfájlokat, hogy az garantálja az Ajax-kódtár Microsoft függőségeinek fenntartását.

Módszer Definition
RegisterScriptControl Regisztrál egy kiszolgálóvezérlőt, amely implementálja a IScriptControlSys.Component ügyfélobjektum meghatározásához használt felületet. A ScriptManager vezérlő rendereli az ügyfélobjektumot támogató szkriptet.
RegisterExtenderControl Regisztrál egy kiszolgálóvezérlőt, amely implementálja a IExtenderControlSys.Component ügyfélobjektum meghatározásához használt felületet. A ScriptManager vezérlő rendereli az ügyfélobjektumot támogató szkriptet.

Partial-Page Frissítéskompatibilis szkriptek regisztrálása

Az alábbi módszerekkel regisztrálhat olyan szkriptfájlokat, amelyek nem függnek az Microsoft Ajax-kódtártól, de kompatibilisek UpdatePanel vezérlőkkel. Ezek a módszerek a vezérlő hasonló módszereinek ClientScriptManager felelnek meg. Ha parancsprogramot jelenít meg egy UpdatePanel vezérlőben való használatra, győződjön meg arról, hogy meghívja a ScriptManager vezérlő metódusait.

Módszer Definition
RegisterArrayDeclaration Értéket ad hozzá Egy JavaScript-tömbhöz. Ha a tömb nem létezik, létrejön.
RegisterClientScriptBlock A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript sztringparaméterként van megadva.
RegisterClientScriptInclude A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript tartalma úgy van megadva, hogy az src attribútumot egy szkriptfájlra mutató URL-címre állítja.
RegisterClientScriptResource A lap nyitó script címkéje után megjelenít egy <form> elemet. A szkript tartalma erőforrásnévvel van megadva egy szerelvényben. Az src attribútumot egy HTTP-kezelő hívása automatikusan feltölti EGY URL-címmel, amely lekéri az elnevezett szkriptet a szerelvényből.
RegisterExpandoAttribute Egy egyéni név-érték attribútumpárt (egy expandót) jelenít meg egy adott vezérlőelem jelölőjében.
RegisterHiddenField Rejtett mező megjelenítése.
RegisterOnSubmitStatement Regisztrál egy szkriptet, amelyet az form elem eseményére submit válaszul hajtanak végre. Az onSubmit attribútum a megadott szkriptre hivatkozik.
RegisterStartupScript Az indítási szkriptblokkot a lap záró </form> címkéje előtt jeleníti meg. A renderelendő szkript sztringparaméterként van megadva.

Metódusok regisztrálásakor meg kell adnia egy típus-kulcspárt a szkripthez. Ha egy azonos típusú/kulcspárt tartalmazó szkript már regisztrálva van, a rendszer nem regisztrál egy új szkriptet. Hasonlóképpen, ha már létező típus-/erőforrásnév-párral regisztrál egy szkriptet, a rendszer nem adja hozzá újra az script erőforrásra hivatkozó elemet. Ha egy korábban regisztrált attribútum expando attribútumát regisztrálja, a rendszer kivételt jelez. A tömbértékek duplikált regisztrálása engedélyezett.

Amikor meghívja a RegisterClientScriptInclude metódust, kerülje a RegisterClientScriptResource beágyazott függvényeket végrehajtó szkript regisztrálását. Ehelyett regisztráljon olyan szkriptet, amely olyan függvénydefiníciókat tartalmaz, mint az eseménykezelők vagy az alkalmazás egyéni osztálydefiníciói.

Az UpdatePanel-vezérlők regisztrációs módszerei

A vezérlők használatakor UpdatePanel a következő módszerekkel testre szabhatja a részleges oldalfrissítéseket.

Módszer Definition
RegisterAsyncPostBackControl Egy vezérlőt regisztrál eseményindítóként az aszinkron visszavételekhez.
RegisterDataItem Egyéni adatokat küld a vezérlőknek a részleges oldalmegjelenítés során.
RegisterDispose Egy vezérlőn belül található vezérlőkhöz regisztrál egy megsemmisítő szkriptet UpdatePanel . A szkript a vezérlő frissítésekor vagy törlésekor UpdatePanel lesz végrehajtva. Az elidegenítési módszer olyan ügyfélösszetevőkhöz használatos, amelyek az Ajax-kódtár Microsoft részét képezik, és amelyeknek erőforrásokat kell felszabadítania, ha már nem használnak összetevőt.
RegisterPostBackControl Egy vezérlőt regisztrál eseményindítóként a teljes visszavételhez. Ez a módszer olyan vezérlők vezérlőihez UpdatePanel használható, amelyek egyébként aszinkron utómunkát hajtanak végre.

Webszolgáltatás-hivatkozások

Az ügyfélszkriptből meghívandó webszolgáltatást regisztrálhatja úgy, hogy létrehoz egy ServiceReference objektumot, és hozzáadja a ServicesScriptManager vezérlő gyűjteményéhez. ASP.NET létrehoz egy ügyfélproxy-objektumot a ServiceReference gyűjtemény minden egyes Services objektumához. A webszolgáltatások futásidőben történő regisztrálásához programozott módon hozzáadhat ServiceReference objektumokat a Services gyűjteményhez.

További információ a webszolgáltatások parancsfájlban való eléréséről: A webszolgáltatások ügyfélszkriptje az ASP.NET AJAX és A webszolgáltatások hívása ügyfélszkriptből ASP.NET AJAX.

Lokalizáció

A ScriptManager vezérlő olyan hivatkozásokat hoz létre a renderelt lapon, amelyek a megfelelő honosított szkriptfájlokra mutatnak, amelyek vagy szerelvényekbe ágyazott szkriptfájlok, vagy különálló szkriptfájlok.

A tulajdonság beállításakor EnableScriptLocalizationa true vezérlőelem lekéri az ScriptManager aktuális kultúrához tartozó honosított erőforrásokat (például honosított sztringeket), ha léteznek. A ScriptManager vezérlő a következő funkciókat biztosítja a honosított erőforrások használatához:

  • Szerelvénybe beágyazott szkriptfájlok. A ScriptManager vezérlő határozza meg, hogy melyik kultúraspecifikus vagy tartalék kultúra szkriptfájlt küldje el a böngészőnek. Ehhez használja a kultúraspecifikus NeutralResourcesLanguageAttribute szerelvény attribútumot, a szerelvényhez csomagolt erőforrásokat és a böngésző felhasználói felületi kultúráját (ha van ilyen).

  • Különálló szkriptfájlok. A ScriptManager vezérlő meghatározza az objektum tulajdonságával ResourceUICulturesScriptReference támogatott felhasználói felületi kultúrák listáját.

  • Hibakeresési módban. A ScriptManager vezérlő megpróbál megjeleníteni egy kultúraspecifikus szkriptfájlt, amely hibakeresési információkat tartalmaz. Ha például a lap hibakeresési módban van, és az aktuális kultúra en-MXvan beállítva, a vezérlő egy olyan szkriptfájlt jelenít meg, amelynek neve például scriptname.en-MX.debug.js, ha a fájl létezik. Ha a fájl nem létezik, a rendszer megjeleníti a megfelelő tartalék kultúrához tartozó hibakeresési fájlt

Az erőforrások honosításával kapcsolatos további információkért lásd: Erőforrások honosítása összetevőtárakhoz – áttekintés.

Hibakezelés

Ha az aszinkron utómunkák során laphiba lép fel, az AsyncPostBackError esemény létre lesz hozva. A kiszolgáló hibáinak az ügyfélnek való elküldésének módja a AllowCustomErrorsRedirect tulajdonságtól, a AsyncPostBackErrorMessage tulajdonságtól és a Web.config fájl egyéni hibák szakaszától függ. További információ: Az UpdatePanel-vezérlők hibakezelésének testreszabása.

Deklaratív szintaxis

<asp:ScriptManager
    AllowCustomErrorsRedirect="True|False"
    AsyncPostBackErrorMessage="string"
    AsyncPostBackTimeout="integer"
    AuthenticationService-Path="uri"
    EnablePageMethods="True|False"
    EnablePartialRendering="True|False"
    EnableScriptGlobalization="True|False"
    EnableScriptLocalization="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    LoadScriptsBeforeUI="True|False"
    OnAsyncPostBackError="AsyncPostBackError event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnResolveScriptReference="ResolveScriptReference event handler"
    OnUnload="Unload event handler"
    ProfileService-LoadProperties="string"
    ProfileService-Path="uri"
    RoleService-LoadRoles="True|False"
    RoleService-Path="uri"
    runat="server"
    ScriptMode="Auto|Inherit|Debug|Release"
    ScriptPath="string"
    SkinID="string"
    SupportsPartialRendering="True|False"
    Visible="True|False"
>
        <AuthenticationService
            Path="uri"
        />
        <ProfileService
            LoadProperties="string"
            Path="uri"
        />
        <RoleService
            LoadRoles="True|False"
            Path="uri"
        />
        <Scripts>
            <asp:ScriptReference
                Assembly="string"
                IgnoreScriptPath="True|False"
                Name="string"
                NotifyScriptLoaded="True|False"
                Path="string"
                ResourceUICultures="string"
                ScriptMode="Auto|Debug|Inherit|Release"
            />
        </Scripts>
        <Services>
            <asp:ServiceReference
                InlineScript="True|False"
                Path="string"
            />
        </Services>
</asp:ScriptManager>

Konstruktorok

Name Description
ScriptManager()

Inicializálja a ScriptManager osztály új példányát.

Tulajdonságok

Name Description
Adapter

Lekéri a vezérlő böngészőspecifikus adapterét.

(Öröklődés forrása Control)
AjaxFrameworkAssembly

Lekéri a lap összetevői által használt Ajax-keretrendszer-szerelvényt.

AjaxFrameworkMode

Lekéri vagy beállít egy értéket, amely meghatározza, hogy az Ajax-ügyfélkódtár Microsoft ügyfélszkriptjei hogyan legyenek belefoglalva az ügyfélbe.

AllowCustomErrorsRedirect

Lekéri vagy beállít egy értéket, amely meghatározza, hogy a Web.config fájl egyéni hibaszakasza használható-e az aszinkron utómunkák során.

AppRelativeTemplateSourceDirectory

Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl.

(Öröklődés forrása Control)
AsyncPostBackErrorMessage

Lekéri vagy beállítja az ügyfélnek küldött hibaüzenetet, ha egy aszinkron visszavétel során nem kezelt kiszolgálói kivétel lép fel.

AsyncPostBackSourceElementID

Lekéri annak a vezérlőnek az egyedi azonosítóját, amely az aszinkron visszavételt okozta.

AsyncPostBackTimeout

Lekéri vagy beállít egy értéket, amely másodpercek alatt jelzi az aszinkron postbackek időtúllépését, ha nem érkezik válasz.

AuthenticationService

Lekéri az AuthenticationServiceManager aktuális ScriptManager példányhoz társított objektumot.

BindingContainer

Lekéri a vezérlő adatkötését tartalmazó vezérlőt.

(Öröklődés forrása Control)
ChildControlsCreated

Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e.

(Öröklődés forrása Control)
ClientID

Lekéri a ASP.NET által létrehozott HTML-korrektúra vezérlőazonosítóját.

(Öröklődés forrása Control)
ClientIDMode

Lekéri vagy beállítja a tulajdonság értékének létrehozásához használt algoritmust ClientID .

(Öröklődés forrása Control)
ClientIDSeparator

Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli.

(Öröklődés forrása Control)
ClientNavigateHandler

Lekéri vagy beállítja annak a metódusnak a nevét, amely kezeli a Sys.Application.navigate eseményt az ügyfélen.

CompositeScript

A weblapot támogató összetett szkriptre mutató hivatkozást kap.

Context

Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot.

(Öröklődés forrása Control)
Controls

ControlCollection Lekéri az objektumot, amely egy adott kiszolgálóvezérlő gyermekvezérlőit jelöli a felhasználói felületi hierarchiában.

(Öröklődés forrása Control)
DataItemContainer

Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer.

(Öröklődés forrása Control)
DataKeysContainer

Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl.

(Öröklődés forrása Control)
DesignMode

Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen.

(Öröklődés forrása Control)
EmptyPageUrl

Lekéri vagy beállítja az URL-címet egy üres weblapra.

EnableCdn

Meghatározza, hogy az aktuális oldal betölti-e az ügyfélszkript-hivatkozásokat a CDN (Content Delivery Network) elérési útjaiból.

EnableCdnFallback

Lehetővé teszi egy szkript helyi másolatának betöltését abban az esetben, ha a CDN (Content Delivery Network) nem érhető el.

EnableHistory

Lekéri vagy beállít egy értéket, amely jelzi, hogy a weblap támogatja-e az előzménypont-kezelést.

EnablePageMethods

Lekéri vagy beállít egy értéket, amely jelzi, hogy egy ASP.NET lapon lévő nyilvános statikus lap metódusai meghívhatók-e ügyfélszkriptből.

EnablePartialRendering

Lekéri vagy beállít egy olyan értéket, amely lehetővé teszi egy oldal részleges renderelését, ami lehetővé teszi a lap régióinak külön-külön történő frissítését vezérlők használatával UpdatePanel .

EnableScriptGlobalization

Lekéri vagy beállít egy értéket, amely jelzi, hogy a ScriptManager vezérlő olyan szkriptet jelenít-e meg, amely támogatja a kultúraspecifikus információk elemzését és formázását.

EnableScriptLocalization

Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő megjeleníti-e a ScriptManager szkriptfájlok honosított verzióit.

EnableSecureHistoryState

Lekéri vagy beállít egy értéket, amely jelzi, hogy titkosítja-e az előzményállapot-sztringet.

EnableTheming

Lekéri vagy beállít egy értéket, amely jelzi, hogy a témák vonatkoznak-e erre a vezérlőre.

(Öröklődés forrása Control)
EnableViewState

Lekéri vagy beállít egy értéket, amely jelzi, hogy a kiszolgálóvezérlő megőrzi-e a nézetállapotát, és hogy a gyermekvezérlők nézetállapota megmarad-e a kérést kérő ügyfélnek.

(Öröklődés forrása Control)
Events

Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett.

(Öröklődés forrása Control)
HasChildViewState

Beolvas egy értéket, amely jelzi, hogy az aktuális kiszolgálóvezérlő gyermekvezérlői rendelkeznek-e mentett nézetállapot-beállításokkal.

(Öröklődés forrása Control)
ID

Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót.

(Öröklődés forrása Control)
IdSeparator

Lekéri a vezérlőazonosítók elválasztásához használt karaktert.

(Öröklődés forrása Control)
IsChildControlStateCleared

Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal.

(Öröklődés forrása Control)
IsDebuggingEnabled

Olyan értéket kap, amely jelzi, hogy az ügyfélszkript-kódtárak hibakeresési verziói renderelve lesznek-e.

IsInAsyncPostBack

Olyan értéket kap, amely jelzi, hogy az aktuális visszavétel részleges renderelési módban van-e végrehajtva.

IsNavigating

Beolvas egy értéket, amely jelzi, hogy egy esemény kezelése folyamatban van-e Navigate .

IsTrackingViewState

Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait.

(Öröklődés forrása Control)
IsViewStateEnabled

Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez.

(Öröklődés forrása Control)
LoadScriptsBeforeUI

Lekéri vagy beállít egy értéket, amely jelzi, hogy a szkriptek betöltve vannak-e az oldal felhasználói felületének korrektúrái előtt vagy után.

LoadViewStateByID

Beolvas egy értéket, amely jelzi, hogy a vezérlő részt vesz-e a nézet állapotának index helyett való ID betöltésében.

(Öröklődés forrása Control)
NamingContainer

Lekéri a kiszolgálóvezérlő elnevezési tárolójára mutató hivatkozást, amely egyedi névteret hoz létre az azonos ID tulajdonságértékkel rendelkező kiszolgálóvezérlők megkülönböztetéséhez.

(Öröklődés forrása Control)
Page

A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap.

(Öröklődés forrása Control)
Parent

Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában.

(Öröklődés forrása Control)
ProfileService

Lekéri az ProfileServiceManager aktuális ScriptManager példányhoz társított objektumot.

RenderingCompatibility

Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e.

(Öröklődés forrása Control)
RoleService

Lekéri az RoleServiceManager aktuális ScriptManager példányhoz társított objektumot.

ScriptMode

Lekéri vagy beállít egy értéket, amely meghatározza, hogy az ügyfélszkript-kódtárak hibakeresési vagy kiadási verziói renderelve vannak-e.

ScriptPath
Elavult.

Lekéri vagy beállítja annak a helynek a gyökérútvonalát, amely az Ajax- és egyéni szkriptfájlok ASP.NET elérési útjainak létrehozásához használatos.

ScriptResourceMapping

Lekéri az objektumot ScriptResourceMapping .

Scripts

ScriptReferenceCollection Lekéri az ScriptReference objektumokat tartalmazó objektumokat, amelyek mindegyike az ügyfél számára renderelt szkriptfájlt jelöli.

Services

Lekéri a ServiceReferenceCollection objektumot, amely ServiceReference objektumot tartalmaz minden olyan webszolgáltatáshoz, amelyet ASP.NET elérhetővé tesz az ügyfélen az Ajax-funkciókhoz.

Site

Információt kap arról a tárolóról, amely az aktuális vezérlőt üzemelteti, amikor egy tervezőfelületen rendereli.

(Öröklődés forrása Control)
SkinID

Lekéri vagy beállítja a bőrt, hogy alkalmazza a vezérlőt.

(Öröklődés forrása Control)
SupportsPartialRendering

Beolvas egy értéket, amely jelzi, hogy az ügyfél támogatja-e a részleges oldalmegjelenítést.

TemplateControl

Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást.

(Öröklődés forrása Control)
TemplateSourceDirectory

Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl.

(Öröklődés forrása Control)
UniqueID

Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót.

(Öröklődés forrása Control)
ValidateRequestMode

Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő ellenőrzi-e a böngészőből érkező ügyfélbemenetet a potenciálisan veszélyes értékekért.

(Öröklődés forrása Control)
ViewState

Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy kiszolgálóvezérlő nézetállapotának mentését és visszaállítását ugyanazon lap több kérése között.

(Öröklődés forrása Control)
ViewStateIgnoresCase

Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e.

(Öröklődés forrása Control)
ViewStateMode

Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját.

(Öröklődés forrása Control)
Visible

Felülbírálja az Visible alaposztálytól Control örökölt tulajdonságot az érték beállításának megakadályozása érdekében.

Metódusok

Name Description
AddedControl(Control, Int32)

A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az ControlsControl objektum gyűjteményéhez.

(Öröklődés forrása Control)
AddHistoryPoint(NameValueCollection, String)

Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotadatok gyűjtésével és állapotcímével.

AddHistoryPoint(String, String, String)

Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotkulcs, állapotérték és állapotcím használatával.

AddHistoryPoint(String, String)

Létrehoz egy előzménypontot, és hozzáadja a böngésző előzményvereméhez a megadott állapotkulcs és állapotérték használatával.

AddParsedSubObject(Object)

Értesíti a kiszolgálóvezérlőt, hogy egy ELEM (XML vagy HTML) elemzése megtörtént, és hozzáadja az elemet a kiszolgálóvezérlő objektumához ControlCollection .

(Öröklődés forrása Control)
ApplyStyleSheetSkin(Page)

Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre.

(Öröklődés forrása Control)
BeginRenderTracing(TextWriter, Object)

Megkezdi a renderelési adatok tervezési idejének nyomon követését.

(Öröklődés forrása Control)
BuildProfileTree(String, Boolean)

Adatokat gyűjt a kiszolgálóvezérlőről, és elküldi azt a Trace tulajdonságnak, amely akkor jelenik meg, ha a nyomkövetés engedélyezve van az oldalon.

(Öröklődés forrása Control)
ClearCachedClientID()

A gyorsítótárazott ClientID érték beállítása a következőre null: .

(Öröklődés forrása Control)
ClearChildControlState()

Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait.

(Öröklődés forrása Control)
ClearChildState()

Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit.

(Öröklődés forrása Control)
ClearChildViewState()

Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait.

(Öröklődés forrása Control)
ClearEffectiveClientIDMode()

ClientIDMode Az aktuális vezérlőpéldány és a gyermekvezérlők tulajdonságát a következőre Inheritállítja be: .

(Öröklődés forrása Control)
CreateChildControls()

A ASP.NET lap keretrendszere meghívta, hogy értesítse a kompozícióalapú implementációt használó kiszolgálóvezérlőket az általuk tartalmazott gyermekvezérlők létrehozására a visszaküldésre vagy a renderelésre való felkészüléshez.

(Öröklődés forrása Control)
CreateControlCollection()

Létrehoz egy új ControlCollection objektumot a kiszolgálóvezérlő gyermekvezérlőinek (konstans és kiszolgáló) tárolásához.

(Öröklődés forrása Control)
DataBind()

Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti.

(Öröklődés forrása Control)
DataBind(Boolean)

Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására.

(Öröklődés forrása Control)
DataBindChildren()

Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez.

(Öröklődés forrása Control)
Dispose()

Lehetővé teszi a kiszolgálóvezérlők számára a végleges törlést, mielőtt felszabadítanák a memóriából.

(Öröklődés forrása Control)
EndRenderTracing(TextWriter, Object)

Befejezi a renderelési adatok tervezési idejének nyomon követését.

(Öröklődés forrása Control)
EnsureChildControls()

Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre.

(Öröklődés forrása Control)
EnsureID()

Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító.

(Öröklődés forrása Control)
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
FindControl(String, Int32)

Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott id és a paraméterben pathOffset megadott egész számmal, amely segíti a keresést. Nem bírálhatja felül a FindControl metódus ezen verzióját.

(Öröklődés forrása Control)
FindControl(String)

Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott id paraméterrel.

(Öröklődés forrása Control)
Focus()

Vezérlőre állítja a bemeneti fókuszt.

(Öröklődés forrása Control)
GetCurrent(Page)

Lekéri egy ScriptManager adott Page objektum példányát.

GetDesignModeState()

Lekéri a vezérlők tervezési idejének adatait.

(Öröklődés forrása Control)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetRegisteredArrayDeclarations()

Lekéri az objektumban korábban regisztrált ECMAScript -tömbdeklarációk írásvédett gyűjteményét Page .

GetRegisteredClientScriptBlocks()

Lekéri a vezérlővel korábban regisztrált ügyfélszkriptblokkok írásvédett gyűjteményét ScriptManager .

GetRegisteredDisposeScripts()

Lekéri az objektumban korábban regisztrált szkriptek írásvédett gyűjteményét disposePage .

GetRegisteredExpandoAttributes()

Lekéri az objektumban korábban regisztrált egyéni (expando) attribútumok írásvédett gyűjteményét Page .

GetRegisteredHiddenFields()

Lekéri az objektumban korábban regisztrált rejtett mezők írásvédett gyűjteményét Page .

GetRegisteredOnSubmitStatements()

Lekéri az objektumban korábban regisztrált utasítások írásvédett gyűjteményét onsubmitPage .

GetRegisteredStartupScripts()

Lekéri az objektumban korábban regisztrált indítási szkriptek írásvédett gyűjteményét Page .

GetRouteUrl(Object)

Lekéri az útvonalparamétereknek megfelelő URL-címet.

(Öröklődés forrása Control)
GetRouteUrl(RouteValueDictionary)

Lekéri az útvonalparamétereknek megfelelő URL-címet.

(Öröklődés forrása Control)
GetRouteUrl(String, Object)

Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet.

(Öröklődés forrása Control)
GetRouteUrl(String, RouteValueDictionary)

Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet.

(Öröklődés forrása Control)
GetStateString()

Olyan sztringet kér le, amely a weblap állapotát képviselő kulcs-érték párokat tartalmaz.

GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
GetUniqueIDRelativeTo(Control)

A megadott vezérlőelem tulajdonságának UniqueID előtaggal jelölt részét adja vissza.

(Öröklődés forrása Control)
HasControls()

Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket.

(Öröklődés forrása Control)
HasEvents()

Egy értéket ad vissza, amely jelzi, hogy az események regisztrálva vannak-e a vezérlőelemhez vagy bármely gyermekvezérlőhöz.

(Öröklődés forrása Control)
IsLiteralContent()

Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e.

(Öröklődés forrása Control)
LoadControlState(Object)

Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett.

(Öröklődés forrása Control)
LoadPostData(String, NameValueCollection)

Beolvassa a böngészőből a kiszolgálóra közzétett űrlapadatokat, és meghatározza az aszinkron visszavétel forrását.

LoadViewState(Object)

Visszaállítja a nézetállapot adatait egy korábbi oldalkérésből, amelyet a SaveViewState() metódus mentett.

(Öröklődés forrása Control)
MapPathSecure(String)

Lekéri azt a fizikai útvonalat, amelybe egy virtuális elérési út abszolút vagy relatív értékként van leképezve.

(Öröklődés forrása Control)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Az eseményt emeli AsyncPostBackError ki.

OnBubbleEvent(Object, EventArgs)

Meghatározza, hogy a kiszolgálóvezérlő eseménye átadva van-e a lap felhasználói felület kiszolgálóvezérlő hierarchiájának.

(Öröklődés forrása Control)
OnDataBinding(EventArgs)

Az eseményt emeli DataBinding ki.

(Öröklődés forrása Control)
OnInit(EventArgs)

Beállítja az eseményt Init , és gondoskodik arról, hogy csak egy ScriptManager vezérlő legyen a lapon.

OnLoad(EventArgs)

Az eseményt emeli Load ki.

(Öröklődés forrása Control)
OnPreRender(EventArgs)

Aktiválja az PreRender eseményt, és szkriptfájlokat és szolgáltatásokat regisztrál a részleges oldalfrissítésekhez.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Az eseményt emeli ResolveCompositeScriptReference ki.

OnResolveScriptReference(ScriptReferenceEventArgs)

ResolveScriptReference A vezérlő által felügyelt szkripthivatkozások eseményét emeli ScriptManager ki.

OnUnload(EventArgs)

Az eseményt emeli Unload ki.

(Öröklődés forrása Control)
OpenFile(String)

Lekéri a Stream fájl olvasásához használt fájlokat.

(Öröklődés forrása Control)
RaiseBubbleEvent(Object, EventArgs)

Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének.

(Öröklődés forrása Control)
RaisePostBackEvent(String)

Feldolgozza a ScriptManager vezérlőelem által kiváltott utólagos eseményt, és betölti a weblap előzményállapotát.

RaisePostDataChangedEvent()

Eseményeket hoz elő a ScriptManager vezérlő számára, amikor visszahelyozza a kiszolgálóra.

RegisterArrayDeclaration(Control, String, String)

Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

RegisterArrayDeclaration(Page, String, String)

Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

RegisterAsyncPostBackControl(Control)

Egy vezérlőt regisztrál eseményindítóként az aszinkron visszavételekhez.

RegisterClientScriptBlock(Control, Type, String, String, Boolean)

Regisztrál egy ügyfélszkriptblokkot a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáadja a szkriptblokkot a laphoz.

RegisterClientScriptBlock(Page, Type, String, String, Boolean)

Regisztrál egy ügyfélszkriptblokkot a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáadja a szkriptblokkot a laphoz.

RegisterClientScriptInclude(Control, Type, String, String)

Regisztrál egy ügyfélszkriptfájlt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.

RegisterClientScriptInclude(Page, Type, String, String)

Minden alkalommal regisztrálja az ügyfélszkriptet a ScriptManager vezérlővel, amikor aszinkron utólagos visszaállítás történik, majd hozzáad egy szkriptfájlra mutató hivatkozást a laphoz.

RegisterClientScriptResource(Control, Type, String)

Regisztrálja a szerelvénybe ágyazott ügyfélszkriptet a ScriptManager részbenoldalas megjelenítésben részt vevő vezérlővel való használatra.

RegisterClientScriptResource(Page, Type, String)

Regisztrál egy olyan ügyfélszkriptfájlt, amely egy szerelvénybe van ágyazva, minden alkalommal, ScriptManager amikor a visszavétel történik.

RegisterDataItem(Control, String, Boolean)

Egyéni adatokat küld egy vezérlőnek a részleges oldalmegjelenítés során, és jelzi, hogy az adatok JavaScript Object Notation (JSON) formátumban vannak-e.

RegisterDataItem(Control, String)

Egyéni adatokat küld egy vezérlőnek a részleges oldalmegjelenítés során.

RegisterDispose(Control, String)

dispose Egy vezérlőn belüli vezérlőelem szkriptjének regisztrálásaUpdatePanel. A szkript a vezérlő frissítésekor vagy törlésekor UpdatePanel lesz végrehajtva.

RegisterExpandoAttribute(Control, String, String, String, Boolean)

Egy név-érték pár regisztrálása a ScriptManager vezérlővel egy adott vezérlőelem egyéni (expando) attribútumaként.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Regisztrál egy bővítő vezérlőelemet az aktuális ScriptManager példánnyal.

RegisterHiddenField(Control, String, String)

Egy vezérlőelemen belüli ScriptManager vezérlőelem vezérlőelemével UpdatePanel egy rejtett mezőt regisztrál.

RegisterHiddenField(Page, String, String)

Egy rejtett mezőt regisztrál a vezérlővel minden ScriptManager aszinkron visszavétel során.

RegisterNamedClientScriptResource(Control, String)

Az ügyfélszkriptet erőforrásnév alapján regisztrálja, amely egy szerelvénybe van ágyazva, és a ScriptManager vezérlőt egy részbenoldalas renderelésben részt vevő vezérlővel használja.

RegisterNamedClientScriptResource(Page, String)

Az ügyfélszkriptet erőforrásnév alapján regisztrálja, amely egy szerelvénybe van ágyazva, és a ScriptManager vezérlőt egy részbenoldalas renderelésben részt vevő vezérlővel használja.

RegisterOnSubmitStatement(Control, Type, String, String)

Regisztrálja az ECMAScript -kódot (JavaScript) egy ScriptManager vezérlő vezérlőjével, amelyet egy UpdatePanel olyan vezérlővel használ, amely az űrlap elküldésekor lesz végrehajtva.

RegisterOnSubmitStatement(Page, Type, String, String)

Regisztrálja az ECMAScript -kódot (JavaScript) egy ScriptManager vezérlő vezérlőjével, amelyet egy UpdatePanel olyan vezérlővel használ, amely az űrlap elküldésekor lesz végrehajtva.

RegisterPostBackControl(Control)

Egy vezérlőt regisztrál eseményindítóként a postbackhez. Ez a módszer a postback vezérlők konfigurálására szolgál olyan UpdatePanel vezérlőn belül, amely egyébként aszinkron utóvisszavételt végezne.

RegisterScriptControl<TScriptControl>(TScriptControl)

Egy szkriptvezérlőt regisztrál az aktuális ScriptManager példánnyal.

RegisterScriptDescriptors(IExtenderControl)

Visszahív egy ExtenderControl osztályt, hogy olyan példányszkripteket adjon vissza, amelyeket renderelni kell az ügyfélobjektum támogatásához, amely egy ügyfélvezérlőt, összetevőt vagy viselkedést jelöl.

RegisterScriptDescriptors(IScriptControl)

Meghív egy osztályt ScriptControl , hogy olyan példányszkripteket adjon vissza, amelyeket renderelni kell az ügyfélobjektum támogatásához, amely egy ügyfélvezérlőt, összetevőt vagy viselkedést jelöl.

RegisterStartupScript(Control, Type, String, String, Boolean)

Regisztrál egy indítási szkriptblokkot egy vezérlőelemhez, amely egy UpdatePanel vezérlőn belül ScriptManager található, és hozzáadja a szkriptblokkot a laphoz.

RegisterStartupScript(Page, Type, String, String, Boolean)

Regisztrál egy indítási szkriptblokkot minden aszinkron utómunkához a ScriptManager vezérlővel, és hozzáadja a szkriptblokkot a laphoz.

RemovedControl(Control)

A rendszer meghívja a gyermekvezérlőt az Controls objektum gyűjteményéből való Control eltávolítása után.

(Öröklődés forrása Control)
Render(HtmlTextWriter)

A vezérlő tartalmát a ScriptManager megadott HtmlTextWriter objektummal jeleníti meg a böngészőben.

RenderChildren(HtmlTextWriter)

Egy kiszolgálóvezérlő gyermekeinek tartalmát egy megadott HtmlTextWriter objektumba adja ki, amely megírja a megjelenítendő tartalmat az ügyfélen.

(Öröklődés forrása Control)
RenderControl(HtmlTextWriter, ControlAdapter)

A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli.

(Öröklődés forrása Control)
RenderControl(HtmlTextWriter)

A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja.

(Öröklődés forrása Control)
ResolveAdapter()

Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert.

(Öröklődés forrása Control)
ResolveClientUrl(String)

Lekéri a böngésző által használható URL-címet.

(Öröklődés forrása Control)
ResolveUrl(String)

Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá.

(Öröklődés forrása Control)
SaveControlState()

Menti azokat a kiszolgálóvezérlő-állapotváltozásokat, amelyek a lap kiszolgálóra való visszatérése óta történtek.

(Öröklődés forrása Control)
SaveViewState()

Menti azokat a kiszolgálóvezérlő nézetállapot-módosításokat, amelyek a lap kiszolgálóra való visszatérése óta történtek.

(Öröklődés forrása Control)
SetDesignModeState(IDictionary)

Beállítja a vezérlőelemek tervezési idejének adatait.

(Öröklődés forrása Control)
SetFocus(Control)

Beállítja a böngészőfókuszt a megadott vezérlőre.

SetFocus(String)

Beállítja a böngészőfókuszt az azonosító által megadott vezérlőre.

SetRenderMethodDelegate(RenderMethod)

Hozzárendel egy eseménykezelő delegáltat, hogy a kiszolgálóvezérlőt és annak tartalmát a szülővezérlőbe renderelje.

(Öröklődés forrása Control)
SetTraceData(Object, Object, Object)

Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomkövetéséhez a nyomkövetési objektum, a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával.

(Öröklődés forrása Control)
SetTraceData(Object, Object)

Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomon követéséhez a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával.

(Öröklődés forrása Control)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)
TrackViewState()

A kiszolgálóvezérlő nézetállapot-változásainak nyomon követését okozza, hogy azok a kiszolgálóvezérlő StateBag objektumában tárolhatók legyenek. Ez az objektum a ViewState tulajdonságon keresztül érhető el.

(Öröklődés forrása Control)

esemény

Name Description
AsyncPostBackError

Akkor fordul elő, ha az aszinkron visszavétel során laphiba lép fel.

DataBinding

Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik.

(Öröklődés forrása Control)
Disposed

Akkor fordul elő, ha egy kiszolgálóvezérlő felszabadul a memóriából, amely a kiszolgálóvezérlő életciklusának utolsó szakasza, amikor egy ASP.NET lapot kérnek.

(Öröklődés forrása Control)
Init

A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése.

(Öröklődés forrása Control)
Load

Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba.

(Öröklődés forrása Control)
Navigate

Akkor fordul elő, ha a felhasználó a böngésző Vissza vagy Továbbítás gombjára kattint.

PreRender

Az objektum betöltése után Control , de a renderelés előtt következik be.

(Öröklődés forrása Control)
ResolveCompositeScriptReference

Akkor fordul elő, ha egy összetett szkript regisztrálva van a ScriptManager vezérlővel.

ResolveScriptReference

Akkor fordul elő, ha a Scripts gyűjtemény egy tagja regisztrálva van a ScriptManager vezérlővel.

Unload

Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából.

(Öröklődés forrása Control)

Explicit interfész-implementációk

Name Description
IControlBuilderAccessor.ControlBuilder

Ennek a tagnak a leírását lásd ControlBuilder: .

(Öröklődés forrása Control)
IControlDesignerAccessor.GetDesignModeState()

Ennek a tagnak a leírását lásd GetDesignModeState(): .

(Öröklődés forrása Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Ennek a tagnak a leírását lásd SetDesignModeState(IDictionary): .

(Öröklődés forrása Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Ennek a tagnak a leírását lásd SetOwnerControl(Control): .

(Öröklődés forrása Control)
IControlDesignerAccessor.UserData

Ennek a tagnak a leírását lásd UserData: .

(Öröklődés forrása Control)
IDataBindingsAccessor.DataBindings

Ennek a tagnak a leírását lásd DataBindings: .

(Öröklődés forrása Control)
IDataBindingsAccessor.HasDataBindings

Ennek a tagnak a leírását lásd HasDataBindings: .

(Öröklődés forrása Control)
IExpressionsAccessor.Expressions

Ennek a tagnak a leírását lásd Expressions: .

(Öröklődés forrása Control)
IExpressionsAccessor.HasExpressions

Ennek a tagnak a leírását lásd HasExpressions: .

(Öröklődés forrása Control)
IParserAccessor.AddParsedSubObject(Object)

Ennek a tagnak a leírását lásd AddParsedSubObject(Object): .

(Öröklődés forrása Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Ennek a tagnak a leírását lásd LoadPostData(String, NameValueCollection): .

IPostBackDataHandler.RaisePostDataChangedEvent()

Ennek a tagnak a leírását lásd RaisePostDataChangedEvent(): .

IPostBackEventHandler.RaisePostBackEvent(String)

Lehetővé teszi, hogy a ScriptManager vezérlő feldolgozhassa a visszavételi eseményeket, és betöltse a weblap előzményállapotát.

Bővítő metódusok

Name Description
FindDataSourceControl(Control)

A megadott vezérlőhöz tartozó adatforrást adja vissza.

FindFieldTemplate(Control, String)

Visszaadja a megadott oszlop mezősablonját a megadott vezérlő elnevezési tárolójában.

FindMetaTable(Control)

Az adatvezérlő metatáblás objektumát adja vissza.

A következőre érvényes:

Lásd még