ScriptManager Classe

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.Extensions.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Gere bibliotecas de scripts ASP.NET Ajax e ficheiros de script, renderização parcial de páginas e geração de classes proxy de cliente para serviços Web e aplicações.

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

Herança: Object

Control
ScriptManager

Atributos: ToolboxBitmapAttribute

Implementações: IPostBackDataHandler IPostBackEventHandler

Exemplos

Os exemplos seguintes mostram diferentes cenários para usar o ScriptManager controlo.

Ativação de Atualizações Partial-Page

O exemplo seguinte mostra como usar o ScriptManager controlo para permitir atualizações parciais de páginas. Neste exemplo, a Calendar e um DropDownList controlo estão dentro de um UpdatePanel controlo. Por defeito, o valor da UpdateMode propriedade é Always, e o valor da ChildrenAsTriggers propriedade é true. Portanto, os controlos filhos do painel causam um postback assíncrono.


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

Gestão Partial-Page Erros de Atualização e Script de Registo

O exemplo seguinte mostra como fornecer um tratamento personalizado de erros durante atualizações parciais de páginas. Por defeito, quando ocorre um erro durante atualizações parciais de página, é exibida uma caixa de mensagem JavaScript. Este exemplo demonstra como usar o tratamento personalizado de erros fornecendo um handler para o AsyncPostBackError evento e definindo a AsyncPostBackErrorMessage propriedade no handler de eventos. Também pode definir a AllowCustomErrorsRedirect propriedade para especificar como a secção de erros personalizados do ficheiro de Web.config é usada quando ocorre um erro durante atualizações parciais da página. Neste exemplo, é utilizado o valor padrão da AllowCustomErrorsRedirect propriedade. Isto significa que, se o ficheiro Web.config contiver um elemento customErrors , esse elemento determina como os erros são apresentados. Para mais informações, consulte customErrors Element (ASP.NET Settings Schema).

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

Globalização da Data e Hora que São Exibidas no Navegador

O exemplo seguinte mostra como definir a EnableScriptGlobalization propriedade para que o script cliente possa mostrar uma data e hora específicas da cultura no navegador. No exemplo, o Culture atributo da diretiva @ Page é definido como auto. Como resultado, a primeira linguagem especificada nas definições atuais do navegador determina a cultura e a cultura da interface da página. Para mais informações, veja Como: Definir a Cultura e a Cultura da UI para ASP.NET Globalização da Página Web.

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

Observações

Neste tópico:

Introdução
Partial-Page Renderização
Usando o controlo ScriptManager com Páginas Mestres, controlos de utilizador e outros componentes filhos
Gestão e Registo de Guiões
Referências de Serviços Web
Localização
Tratamento de erros
Sintaxe declarativa

Introduction

O controlo ScriptManager é central para a funcionalidade do Ajax em ASP.NET. O controlo gere todos os recursos do ASP.NET Ajax numa página. Isto inclui o download Microsoft scripts da Ajax Library para o navegador e a coordenação de atualizações parciais da página que são ativadas usando controlos UpdatePanel. Além disso, o ScriptManager controlo permite-lhe fazer o seguinte:

Script de registo compatível com atualizações parciais de páginas. Para gerir as dependências entre o seu script e a biblioteca principal, qualquer script que registe é carregado depois do script da Microsoft Ajax Library.
Especifique se scripts de release ou debug são enviados para o navegador.
Fornecer acesso a métodos de serviços Web a partir do script registando serviços Web com o ScriptManager controlo.
Fornecer acesso a serviços de autenticação ASP.NET, função e perfil a partir do script cliente, registando estes serviços com o controlo ScriptManager.
Ative a visualização específica por cultura das funções ECMAScript (JavaScript) Data, Número e String no navegador.
Acede a recursos de localização para ficheiros de script embutidos ou para ficheiros de script autónomos usando a ResourceUICultures propriedade do ScriptReference controlo.
Registar os controlos do servidor que implementam o IExtenderControl ou IScriptControl interagir com o ScriptManager controlo para que o script exigido pelos componentes e comportamentos do cliente seja renderizado.

Partial-Page Renderização

A capacidade de uma página ASP.NET suportar renderização parcial de páginas é controlada pelos seguintes fatores:

A ScriptManager propriedade do EnablePartialRendering controlo deve ser true (o valor padrão).
Deve haver pelo menos um UpdatePanel controlo na página.
A SupportsPartialRendering propriedade deve ser true (o valor padrão). Se a SupportsPartialRendering propriedade não for definida explicitamente, o seu valor baseia-se nas capacidades do navegador.

Pode sobrescrever o valor da EnablePartialRendering propriedade em tempo de execução durante ou antes do evento da Init página. Se tentar alterar esta propriedade depois de o evento da página Init ter ocorrido, é lançada uma InvalidOperationException exceção.

Quando é suportada a renderização de páginas parciais, o controlo ScriptManager renderiza um script para permitir postbacks assíncronos e atualizações de páginas parciais. As regiões da página a atualizar são designadas através de UpdatePanel controlos. O ScriptManager controlo trata dos postbacks assíncronos e atualiza apenas as regiões da página que precisam de ser atualizadas. Para mais informações sobre renderização em páginas parciais, veja Partial-Page Visão Geral de Renderização. Para mais informações sobre as condições que causam uma atualização, consulte Visão Geral de Controlo do Painel de Atualizações.

Usando o controlo ScriptManager com Páginas Mestres, controlos de utilizador e outros componentes filhos

Uma página só pode conter um ScriptManager controlo na sua hierarquia. Para registar serviços e scripts para páginas aninhadas, controlos de utilizador ou componentes quando a página principal já tem um ScriptManager controlo, use o ScriptManagerProxy controlo. Para mais informações, consulte Utilizar o Controlo do Painel de Atualização com Páginas Mestres.

Gestão e Registo de Guiões

O ScriptManager controlo permite-lhe registar um script que depois é renderizado como parte da página. Os ScriptManager métodos de registo de controlo podem ser divididos nas seguintes três categorias:

Métodos de registo que garantem que as dependências de scripts na Biblioteca Microsoft Ajax são mantidas.
Métodos de registo que não dependem da Microsoft Ajax Library, mas que são compatíveis com controlos UpdatePanel.
Métodos de registo que suportam o trabalho com UpdatePanel controlos.

Para mais informações sobre como criar e usar um script Ajax em ASP.NET, consulte Creating Custom Client Script by Using the Microsoft Ajax Library.

Registo de script que depende da biblioteca Microsoft Ajax

Pode usar os seguintes métodos para registar ficheiros de script de forma a garantir que quaisquer dependências da Biblioteca Microsoft Ajax são mantidas.

Method	Definition
RegisterScriptControl	Regista um controlo de servidor que implementa a IScriptControl interface usada para definir um objeto cliente Sys.Component . O ScriptManager controlo renderiza o script que suporta o objeto cliente.
RegisterExtenderControl	Regista um controlo de servidor que implementa a IExtenderControl interface usada para definir um objeto cliente Sys.Component . O ScriptManager controlo renderiza o script que suporta o objeto cliente.

Registo Partial-Page Atualização de Scripts Compatíveis

Pode usar os seguintes métodos para registar ficheiros de script que não dependem da Microsoft Ajax Library, mas que são compatíveis com controlos UpdatePanel. Estes métodos correspondem a métodos semelhantes do ClientScriptManager controlo. Se estiveres a renderizar scripts para usar dentro de um UpdatePanel controlo, certifica-te de que chamas os métodos do ScriptManager controlo.

Method	Definition
RegisterArrayDeclaration	Acrescenta valor a um array JavaScript. Se o array não existir, ele é criado.
RegisterClientScriptBlock	Renderiza um `script` elemento após a etiqueta de abertura `<form>` da página. O script é especificado como um parâmetro de string.
RegisterClientScriptInclude	Renderiza um `script` elemento após a etiqueta de abertura `<form>` da página. O conteúdo do script é especificado definindo o `src` atributo para uma URL que aponta para um ficheiro de script.
RegisterClientScriptResource	Renderiza um `script` elemento após a etiqueta de abertura `<form>` da página. O conteúdo do script é especificado com um nome de recurso numa assembleia. O `src` atributo é automaticamente preenchido com uma URL através de uma chamada a um handler HTTP que recupera o script nomeado da assembly.
RegisterExpandoAttribute	Renderiza um par de atributos nome/valor personalizado (um expando) na marcação para um controlo especificado.
RegisterHiddenField	Renderiza um campo oculto.
RegisterOnSubmitStatement	Regista um script que é executado em resposta ao `form` evento do `submit` elemento. O `onSubmit` atributo refere-se à escrita especificada.
RegisterStartupScript	Renderiza um bloco de script de arranque mesmo antes da tag de fecho `</form>` da página. O script a renderizar é especificado como um parâmetro de string.

Quando registas métodos, especificas um par tipo/chave para esse script. Se um script com o mesmo par tipo/chave já estiver registado, um novo script não é registado. De forma semelhante, se registar um script com um par tipo/nome de recurso que já existe, o script elemento que faz referência ao recurso não é adicionado novamente. Quando regista um atributo expando de um atributo previamente registado, é lançada uma exceção. É permitido o registo duplicado dos valores do array.

Quando chamar o RegisterClientScriptInclude método ou RegisterClientScriptResource ou o método, evite registar scripts que executem funções inline. Em vez disso, um script de registos que contenha definições de funções como gestores de eventos ou definições de classes personalizadas para a sua aplicação.

Métodos de Registo para Controlos do UpdatePanel

Pode usar os seguintes métodos para personalizar atualizações parciais de páginas quando utiliza UpdatePanel controlos.

Method	Definition
RegisterAsyncPostBackControl	Regista um controlo como gatilho para postbacks assíncronos.
RegisterDataItem	Envia dados personalizados para os controlos durante a renderização parcial da página.
RegisterDispose	Regista um script dispose para um controlo que está dentro de um UpdatePanel controlo. O script é executado quando o UpdatePanel controlo é atualizado ou eliminado. O método descarte é usado para componentes clientes que fazem parte da Biblioteca Microsoft Ajax e que têm de libertar recursos quando um componente deixa de ser utilizado.
RegisterPostBackControl	Regista um controlo como gatilho para um postback completo. Este método é usado para controlos dentro de um UpdatePanel controlo que, de outra forma, realizariam postbacks assíncronos.

Referências de Serviços Web

Pode registar um serviço Web para ser chamado a partir do script cliente criando um ServiceReference objeto e adicionando-o à Services coleção do ScriptManager controlo. ASP.NET gera um objeto proxy cliente para cada objeto ServiceReference na coleção Services. Pode adicionar ServiceReference programaticamente objetos à Services coleção para registar serviços Web em tempo de execução.

Para mais informações sobre como aceder a Web Services em script, consulte Exposting Web Services to Client Script em ASP.NET AJAX e Calling Web Services from Client Script em ASP.NET AJAX.

Localização

O ScriptManager controlo gera referências na página renderizada que apontam para os ficheiros de script localizados apropriados, que são ficheiros de script embutidos em assemblies ou ficheiros de script autónomos.

Quando a EnableScriptLocalization propriedade é definida para true, o ScriptManager controlo recupera recursos localizados (como strings localizadas) para a cultura atual, caso existam. O ScriptManager controlo fornece a seguinte funcionalidade para utilização de recursos localizados:

Ficheiros de script que são incorporados numa assembleia. O ScriptManager controlo determina qual ficheiro de script específico da cultura ou de retenção cultural enviar para o navegador. Faz isto usando o atributo assembly específico NeutralResourcesLanguageAttribute da cultura, os recursos empacotados com a assembly e a cultura da interface do navegador (se existir).
Ficheiros de script autónomos. O ScriptManager controlo define a lista de culturas UI suportadas pela utilização da ResourceUICultures propriedade do ScriptReference objeto.
Em modo de depuração. O ScriptManager controlo tenta renderizar um ficheiro de script específico da cultura que contém informação de depuração. Por exemplo, se a página estiver em modo de depuração e a cultura atual estiver definida para en-MX, o controlo renderiza um ficheiro de script com um nome como scriptname.en-MX.debug.js, se o ficheiro existir. Se o ficheiro não existir, o ficheiro de depuração para a cultura de reserva apropriada é renderizado

Para mais informações sobre como localizar recursos, consulte Visão Geral de Localização de Recursos para Bibliotecas de Componentes.

Tratamento de erros

Quando ocorre um erro de página durante postbacks assíncronos, o AsyncPostBackError evento é levantado. A forma como os erros no servidor são enviados ao cliente depende da AllowCustomErrorsRedirect propriedade, da AsyncPostBackErrorMessage propriedade e da secção de erros personalizados do ficheiro Web.config. Para mais informações, consulte Personalização do Tratamento de Erros para Controlos do UpdatePanel (Personalização do Tratamento de Erros para Controlos do Painel de Atualização).

Sintaxe declarativa

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

Construtores

Name	Description
ScriptManager()	Inicializa uma nova instância da ScriptManager classe.

Propriedades

Name	Description
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
AjaxFrameworkAssembly	Obtém o assembly do framework Ajax que os componentes da página usam.
AjaxFrameworkMode	Recebe ou define um valor que especifica como os scripts do cliente da biblioteca cliente Microsoft Ajax serão incluídos no cliente.
AllowCustomErrorsRedirect	Recebe ou define um valor que determina se a secção de erros personalizados do ficheiro de Web.config é usada durante um erro num postback assíncrono.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
AsyncPostBackErrorMessage	Recebe ou define a mensagem de erro enviada ao cliente quando ocorre uma exceção de servidor não tratada durante um postback assíncrono.
AsyncPostBackSourceElementID	Obtém o ID único do controlo que causou o postback assíncrono.
AsyncPostBackTimeout	Recebe ou define um valor que indica o tempo, em segundos, antes dos postbacks assíncronos expirarem se não houver resposta.
AuthenticationService	Obtém o AuthenticationServiceManager objeto associado à instância atual ScriptManager .
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
ClientNavigateHandler	Recebe ou define o nome do método que gere o evento Sys.Application.navigate no cliente.
CompositeScript	Obtém uma referência ao script composto que suporta a página Web.
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de Control)
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
EmptyPageUrl	Obtém ou define um URL para uma página Web em branco.
EnableCdn	Determina se a página atual carrega referências de scripts de cliente a partir de caminhos CDN (Content Delivery Network).
EnableCdnFallback	Permite que a cópia local de um script seja carregada caso a CDN (Rede de Distribuição de Conteúdos) não esteja disponível.
EnableHistory	Recebe ou define um valor que indica se a página Web suporta gestão de pontos de histórico.
EnablePageMethods	Obtém ou define um valor que indica se métodos públicos de página estática numa página ASP.NET podem ser chamados a partir do script cliente.
EnablePartialRendering	Recebe ou define um valor que permite renderização parcial de uma página, o que por sua vez permite atualizar regiões da página individualmente usando UpdatePanel controlos.
EnableScriptGlobalization	Recebe ou define um valor que indica se o ScriptManager controlo renderiza um script que suporta análise e formatação de informação específica da cultura.
EnableScriptLocalization	Recebe ou define um valor que indica se o ScriptManager controlo renderiza versões localizadas dos ficheiros de script.
EnableSecureHistoryState	Recebe ou define um valor que indica se deve encriptar a cadeia de estado histórico.
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de Control)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsDebuggingEnabled	Recebe um valor que indica se as versões de depuração das bibliotecas de scripts do cliente serão renderizadas.
IsInAsyncPostBack	Recebe um valor que indica se o postback atual está a ser executado em modo de renderização parcial.
IsNavigating	Obtém um valor que indica se um Navigate evento está a ser tratado atualmente.
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LoadScriptsBeforeUI	Recebe ou define um valor que indica se os scripts são carregados antes ou depois de a marcação da interface da página ser carregada.
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
ProfileService	Obtém o ProfileServiceManager objeto associado à instância atual ScriptManager .
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RoleService	Obtém o RoleServiceManager objeto associado à instância atual ScriptManager .
ScriptMode	Recebe ou define um valor que especifica se as versões de depuração ou de lançamento das bibliotecas de scripts do cliente são renderizadas.
ScriptPath	Obsoleto. Obtém ou define o caminho raiz da localização usada para construir os caminhos para ficheiros de script ASP.NET Ajax e personalizados.
ScriptResourceMapping	Recebe um ScriptResourceMapping objeto.
Scripts	Obtém um ScriptReferenceCollection objeto que contém os ScriptReference objetos, cada um dos quais representa um ficheiro de script renderizado para o cliente.
Services	Obtém um objeto ServiceReferenceCollection que contém um objeto ServiceReference para cada serviço Web que ASP.NET exposto no cliente para funcionalidades Ajax.
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de Control)
SupportsPartialRendering	Recebe um valor que indica se o cliente suporta renderização parcial de página.
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Sobrepõe a Visible propriedade herdada da classe base Control para evitar definir esse valor.

Métodos

Name	Description
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddHistoryPoint(NameValueCollection, String)	Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a recolha de dados de estado e o título do estado especificados.
AddHistoryPoint(String, String, String)	Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a chave de estado especificada, o valor do estado e o título do estado.
AddHistoryPoint(String, String)	Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a chave de estado e o valor de estado especificados.
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
CreateChildControls()	Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetCurrent(Page)	Obtém a ScriptManager instância de um dado Page objeto.
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetRegisteredArrayDeclarations()	Recupera uma coleção de apenas leitura de declarações de array ECMAScript (JavaScript) que estavam previamente registadas no Page objeto.
GetRegisteredClientScriptBlocks()	Recupera uma coleção de apenas leitura de blocos de script cliente que estavam previamente registados com o ScriptManager controlo.
GetRegisteredDisposeScripts()	Recupera uma coleção `dispose` de scripts apenas de leitura que estavam previamente registados com o Page objeto.
GetRegisteredExpandoAttributes()	Recupera uma coleção de apenas leitura de atributos personalizados (expando) que estavam previamente registados no Page objeto.
GetRegisteredHiddenFields()	Recupera uma coleção de apenas leitura de campos ocultos que estavam previamente registados no Page objeto.
GetRegisteredOnSubmitStatements()	Recupera uma coleção `onsubmit` de instruções apenas de leitura que estavam previamente registadas no Page objeto.
GetRegisteredStartupScripts()	Recupera uma coleção de scripts de arranque que estavam previamente registados no Page objeto.
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetStateString()	Recupera uma cadeia que contém pares chave/valor que representam o estado da página Web.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadPostData(String, NameValueCollection)	Lê os dados do formulário que são publicados do navegador para o servidor e determina a origem do postback assíncrono.
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior de página que foi guardado pelo SaveViewState() método. (Herdado de Control)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Eleva o AsyncPostBackError evento.
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnInit(EventArgs)	Eleva o Init evento e garante que só existe um ScriptManager controlo na página.
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Levanta o PreRender evento e regista ficheiros de script e serviços para atualizações parciais da página.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Eleva o ResolveCompositeScriptReference evento.
OnResolveScriptReference(ScriptReferenceEventArgs)	Aumenta o ResolveScriptReference evento para cada referência de script gerida pelo ScriptManager controlo.
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RaisePostBackEvent(String)	Processa um evento de postback gerado pelo ScriptManager controlo e carrega o estado de histórico da página Web.
RaisePostDataChangedEvent()	Levanta eventos para o ScriptManager controlo quando este é enviado de volta ao servidor.
RegisterArrayDeclaration(Control, String, String)	Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.
RegisterArrayDeclaration(Page, String, String)	Regista uma declaração de array ECMAScript (JavaScript) com o ScriptManager controlo para utilização com um controlo que está dentro de um UpdatePanel controlo, e adiciona o array à página.
RegisterAsyncPostBackControl(Control)	Regista um controlo como gatilho para postbacks assíncronos.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Regista um bloco de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona o bloco de script à página.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Regista um bloco de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona o bloco de script à página.
RegisterClientScriptInclude(Control, Type, String, String)	Regista um ficheiro de script cliente com o ScriptManager controlo para uso com um controlo que está dentro de um UpdatePanel controlo, e depois adiciona uma referência de ficheiro de script à página.
RegisterClientScriptInclude(Page, Type, String, String)	Regista o script cliente com o ScriptManager controlo sempre que ocorre um postback assíncrono, e depois adiciona uma referência a um ficheiro de script à página.
RegisterClientScriptResource(Control, Type, String)	Regista o script cliente que está embutido numa assembleia com o ScriptManager controlo para ser usado com um controlo que participa na renderização parcial da página.
RegisterClientScriptResource(Page, Type, String)	Regista um ficheiro de script cliente que está embutido num assembly com o ScriptManager controlo sempre que ocorre um postback.
RegisterDataItem(Control, String, Boolean)	Envia dados personalizados para um controlo durante a renderização parcial da página e indica se os dados estão em formato JavaScript Object Notation (JSON).
RegisterDataItem(Control, String)	Envia dados personalizados para um controlo durante a renderização parcial da página.
RegisterDispose(Control, String)	Regista um `dispose` script para um controlo que está dentro de um UpdatePanel controlo. O script é executado quando o UpdatePanel controlo é atualizado ou eliminado.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Regista um par nome/valor com o ScriptManager controlo como um atributo personalizado (expando) de um controlo especificado.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Regista um controlo de extensor com a instância atual ScriptManager .
RegisterHiddenField(Control, String, String)	Regista um campo oculto com o ScriptManager controlo para um controlo que está dentro de um UpdatePanel controlo.
RegisterHiddenField(Page, String, String)	Regista um campo oculto com o ScriptManager controlo durante cada postback assíncrono.
RegisterNamedClientScriptResource(Control, String)	Regista o script cliente pelo nome do recurso que está embutido numa assembly com o ScriptManager controlo para ser usado com um controlo que participa na renderização de páginas parciais.
RegisterNamedClientScriptResource(Page, String)	Regista o script cliente pelo nome do recurso que está embutido numa assembly com o ScriptManager controlo para ser usado com um controlo que participa na renderização de páginas parciais.
RegisterOnSubmitStatement(Control, Type, String, String)	Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.
RegisterOnSubmitStatement(Page, Type, String, String)	Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.
RegisterPostBackControl(Control)	Regista um controlo como gatilho para um postback. Este método é usado para configurar controlos de postback dentro de um UpdatePanel controlo que, de outra forma, realizaria postbacks assíncronos.
RegisterScriptControl<TScriptControl>(TScriptControl)	Regista um controlo de script com a instância atual ScriptManager .
RegisterScriptDescriptors(IExtenderControl)	Chama de volta a uma ExtenderControl classe para devolver scripts de instância que devem ser renderizados para suportar o objeto cliente que representa um controlo, componente ou comportamento do cliente.
RegisterScriptDescriptors(IScriptControl)	Chama uma ScriptControl classe para devolver scripts de instância que devem ser renderizados para suportar o objeto cliente que representa um controlo, componente ou comportamento cliente.
RegisterStartupScript(Control, Type, String, String, Boolean)	Regista um bloco de script de arranque para um controlo que está dentro de um UpdatePanel usando o ScriptManager controlo, e adiciona o bloco de script à página.
RegisterStartupScript(Page, Type, String, String, Boolean)	Regista um bloco de script de arranque para cada postback assíncrono com o ScriptManager controlo e adiciona o bloco de script à página.
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o ScriptManager conteúdo do controlo no navegador usando o objeto especificado HtmlTextWriter .
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Guarda quaisquer alterações de estado de visualização no controlo do servidor que tenham ocorrido desde o momento em que a página foi publicada de volta no servidor. (Herdado de Control)
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetFocus(Control)	Define o foco do navegador para o controlo especificado.
SetFocus(String)	Define o foco do navegador para o controlo especificado pelo ID.
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Causa o rastreio das alterações de estado de visualização no controlo do servidor para que possam ser armazenadas no objeto do StateBag controlo do servidor. Este objeto é acessível através da ViewState propriedade. (Herdado de Control)

evento

Name	Description
AsyncPostBackError	Ocorre quando há um erro de página durante um postback assíncrono.
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
Navigate	Ocorre quando o utilizador clica no botão Voltar ou Avançar do navegador.
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
ResolveCompositeScriptReference	Ocorre quando um script composto é registado com o ScriptManager controlo.
ResolveScriptReference	Ocorre quando um membro da Scripts coleção está registado no ScriptManager controlo.
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Para uma descrição deste elemento, veja LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Para uma descrição deste elemento, veja RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Permite ao ScriptManager controlo processar um evento de postback e carregar o estado do histórico da página Web.

Métodos da Extensão

Name	Description
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.

Aplica-se a

Ver também

Comentários

Esta página foi útil?