ScriptManager Classe

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Gerencia arquivos de script e bibliotecas de script ASP.NET Ajax, renderização de página parcial e geração de classe de proxy do cliente para serviços e aplicativos e Web.

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 a seguir mostram cenários diferentes para usar o ScriptManager controle .

Habilitando atualizações de Partial-Page

O exemplo a seguir mostra como usar o ScriptManager controle para habilitar atualizações de página parcial. Neste exemplo, um Calendar e um DropDownList controle estão dentro de um UpdatePanel controle . Por padrão, o valor da UpdateMode propriedade é Alwayse o valor da ChildrenAsTriggers propriedade é true. Portanto, os controles filho 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>

Tratamento Partial-Page erros de atualização e registro de script

O exemplo a seguir mostra como fornecer tratamento de erro personalizado durante atualizações de página parcial. Por padrão, quando ocorre um erro durante atualizações de página parcial, uma caixa de mensagem JavaScript é exibida. Este exemplo demonstra como usar o tratamento de erros personalizados fornecendo um manipulador para o AsyncPostBackError evento e definindo a AsyncPostBackErrorMessage propriedade no manipulador de eventos. Você também pode definir a AllowCustomErrorsRedirect propriedade para especificar como a seção de erros personalizados do arquivo Web.config é usada quando ocorre um erro durante atualizações de página parcial. Neste exemplo, o valor padrão da AllowCustomErrorsRedirect propriedade é usado. Isso significa que, se o arquivo Web.config contiver um elemento customErrors , esse elemento determinará como os erros serão exibidos. Para obter mais informações, consulte Elemento customErrors (esquema de configurações ASP.NET).

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

Globalizando a data e a hora exibidas no navegador

O exemplo a seguir mostra como definir a propriedade para que o EnableScriptGlobalization script do cliente possa exibir uma data e hora específicas da cultura no navegador. No exemplo, o Culture atributo da diretiva @ Page é definido autocomo . Como resultado, o primeiro idioma especificado nas configurações atuais do navegador determina a cultura e a cultura da interface do usuário para a página. Para obter mais informações, consulte Como definir a cultura e a cultura da interface do usuário para ASP.NET globalização de página da 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>

Comentários

Neste tópico:

Introdução
Renderização de página parcial
Usando o controle ScriptManager com páginas mestre, controles de usuário e outros componentes filho
Gerenciamento e registro de script
Referências de serviço Web
Localização
Tratamento de erro
Sintaxe declarativa

Introdução

O ScriptManager controle é central para a funcionalidade do Ajax em ASP.NET. O controle gerencia todos os ASP.NET recursos do Ajax em uma página. Isso inclui o download de scripts da Biblioteca do Microsoft Ajax para o navegador e a coordenação de atualizações de página parcial habilitadas usando UpdatePanel controles. Além disso, o ScriptManager controle permite que você faça o seguinte:

Registre o script compatível com atualizações de página parcial. Para gerenciar dependências entre o script e a biblioteca principal, qualquer script que você registrar será carregado após o script da Biblioteca do Microsoft Ajax.
Especifique se os scripts de versão ou depuração são enviados para o navegador.
Forneça acesso aos métodos de serviço Web do script registrando serviços Web com o ScriptManager controle .
Forneça acesso aos serviços de autenticação, função e perfil de ASP.NET de aplicativos do script do cliente registrando esses serviços com o ScriptManager controle .
Habilite a exibição específica da cultura das funções Date, Number e String do ECMAScript (JavaScript) no navegador.
Acesse recursos de localização para arquivos de script inseridos ou para arquivos de script autônomos usando a ResourceUICultures propriedade do ScriptReference controle .
Registre controles de servidor que implementam as IExtenderControl interfaces ou IScriptControl com o controle para que o ScriptManager script exigido pelos componentes e comportamentos do cliente seja renderizado.

Renderização de página parcial

A capacidade de uma página ASP.NET para dar suporte à renderização de página parcial é controlada pelos seguintes fatores:

A ScriptManager propriedade do EnablePartialRendering controle deve ser true (o valor padrão).
Deve haver pelo menos um UpdatePanel controle na página.
A SupportsPartialRendering propriedade deve ser true (o valor padrão). Se a SupportsPartialRendering propriedade não estiver definida explicitamente, seu valor será baseado nos recursos do navegador.

Você pode substituir o valor da propriedade em tempo de EnablePartialRendering execução durante ou antes do evento da Init página. Se você tentar alterar essa propriedade depois que o evento da Init página tiver ocorrido, uma exceção InvalidOperationException será gerada.

Quando há suporte para a renderização de página parcial, o controle renderiza o ScriptManager script para habilitar postbacks assíncronos e atualizações de página parcial. As regiões da página a ser atualizada são designadas usando UpdatePanel controles. O ScriptManager controle manipula os postbacks assíncronos e atualiza apenas as regiões da página que precisam ser atualizadas. Para obter mais informações sobre renderização de página parcial, consulte Visão geral da renderização de página parcial. Para obter mais informações sobre as condições que causam uma atualização, consulte Visão geral do controle UpdatePanel.

Usando o controle ScriptManager com páginas mestre, controles de usuário e outros componentes filho

Uma página pode conter apenas um ScriptManager controle em sua hierarquia. Para registrar serviços e scripts para páginas aninhadas, controles de usuário ou componentes quando a página pai já tiver um ScriptManager controle, use o ScriptManagerProxy controle . Para obter mais informações, consulte Usando o controle UpdatePanel com páginas mestras.

Gerenciamento e registro de script

O ScriptManager controle permite que você registre o script que é renderizado como parte da página. Os ScriptManager métodos de registro de controle podem ser divididos nas três categorias a seguir:

Métodos de registro que garantem que as dependências de script na Biblioteca do Microsoft Ajax sejam mantidas.
Métodos de registro que não dependem da Biblioteca do Microsoft Ajax, mas que são compatíveis com UpdatePanel controles.
Métodos de registro que dão suporte ao trabalho com UpdatePanel controles.

Para obter mais informações sobre como criar e usar o script Ajax no ASP.NET, consulte Criando script de cliente personalizado usando a biblioteca do Microsoft Ajax.

Registrando o script que depende da Microsoft Ajax Library

Você pode usar os métodos a seguir para registrar arquivos de script de uma maneira que garanta que quaisquer dependências na Biblioteca do Microsoft Ajax sejam mantidas.

Método	Definição
RegisterScriptControl	Registra um controle de servidor que implementa a IScriptControl interface usada para definir um objeto cliente Sys.Component . O ScriptManager controle renderiza o script que dá suporte ao objeto cliente.
RegisterExtenderControl	Registra um controle de servidor que implementa a IExtenderControl interface usada para definir um objeto cliente Sys.Component . O ScriptManager controle renderiza o script que dá suporte ao objeto cliente.

Registrando scripts compatíveis com atualização de página parcial

Você pode usar os métodos a seguir para registrar arquivos de script que não dependem da Biblioteca do Microsoft Ajax, mas que são compatíveis com UpdatePanel controles. Esses métodos correspondem a métodos semelhantes do ClientScriptManager controle . Se você estiver renderizando o script para uso dentro de um UpdatePanel controle, chame os métodos do ScriptManager controle .

Método	Definição
RegisterArrayDeclaration	Adiciona um valor a uma matriz JavaScript. Se a matriz não existir, ela será criada.
RegisterClientScriptBlock	Renderiza um `script` elemento após a marca de abertura `<form>` da página. O script é especificado como um parâmetro de cadeia de caracteres.
RegisterClientScriptInclude	Renderiza um `script` elemento após a marca de abertura `<form>` da página. O conteúdo do script é especificado definindo o `src` atributo como uma URL que aponta para um arquivo de script.
RegisterClientScriptResource	Renderiza um `script` elemento após a marca de abertura `<form>` da página. O conteúdo do script é especificado com um nome de recurso em um assembly. O `src` atributo é preenchido automaticamente com uma URL por uma chamada para um manipulador HTTP que recupera o script nomeado do assembly.
RegisterExpandoAttribute	Renderiza um par de atributos de nome/valor personalizado (um expando) na marcação de um controle especificado.
RegisterHiddenField	Renderiza um campo oculto.
RegisterOnSubmitStatement	Registra um script executado em resposta ao `form` evento do `submit` elemento. O `onSubmit` atributo faz referência ao script especificado.
RegisterStartupScript	Renderiza um bloco de script de inicialização pouco antes da marca de fechamento `</form>` da página. O script a ser renderizado é especificado como um parâmetro de cadeia de caracteres.

Ao registrar métodos, você especifica um par de tipo/chave para esse script. Se um script com o mesmo tipo/par de chaves já estiver registrado, um novo script não será registrado. Da mesma forma, se você registrar um script com um par de nomes de tipo/recurso que já existe, o script elemento que faz referência ao recurso não será adicionado novamente. Quando você registra um atributo expando de um atributo registrado anteriormente, uma exceção é gerada. O registro duplicado de valores de matriz é permitido.

Ao chamar o RegisterClientScriptInclude método ou RegisterClientScriptResource , evite registrar o script que executa funções embutidas. Em vez disso, registre o script que contém definições de função, como manipuladores de eventos ou definições de classe personalizadas para seu aplicativo.

Métodos de registro para controle UpdatePanel

Você pode usar os métodos a seguir para personalizar atualizações de página parcial ao usar UpdatePanel controles.

Método	Definição
RegisterAsyncPostBackControl	Registra um controle como um gatilho para postbacks assíncronos.
RegisterDataItem	Envia dados personalizados para controles durante a renderização parcial da página.
RegisterDispose	Registra um script de descarte para um controle que está dentro de um UpdatePanel controle. O script é executado quando o controle UpdatePanel é atualizado ou excluído. O método dispose é usado para componentes cliente que fazem parte da Biblioteca Microsoft Ajax e que precisam liberar recursos quando um componente não é mais usado.
RegisterPostBackControl	Registra um controle como um gatilho para um postback completo. Esse método é usado para controles dentro de um UpdatePanel controle que, de outra forma, executaria postbacks assíncronos.

Referências de serviço Web

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

Para obter mais informações sobre como acessar serviços Web no script, consulte Expondo serviços Web ao script do cliente em ASP.NET AJAX e Chamando Serviços Web do Script do Cliente em ASP.NET AJAX.

Localização

O ScriptManager controle gera referências na página renderizada que apontam para os arquivos de script localizados apropriados, que são arquivos de script inseridos em assemblies ou arquivos de script autônomos.

Quando a EnableScriptLocalization propriedade é definida truecomo , o ScriptManager controle recupera recursos localizados (como cadeias de caracteres localizadas) para a cultura atual, se eles existirem. O ScriptManager controle fornece a seguinte funcionalidade para usar recursos localizados:

Arquivos de script inseridos em um assembly. O ScriptManager controle determina qual arquivo de script de cultura específica ou de cultura de fallback-culture enviar para o navegador. Ele faz isso usando o atributo de assembly específico NeutralResourcesLanguageAttribute da cultura, os recursos empacotados com o assembly e a cultura da interface do usuário do navegador (se houver).
Arquivos de script autônomos. O ScriptManager controle define a lista de culturas de interface do usuário com suporte usando a ResourceUICultures propriedade do ScriptReference objeto .
No modo de depuração. O ScriptManager controle tenta renderizar um arquivo de script específico da cultura que contém informações de depuração. Por exemplo, se a página estiver no modo de depuração e a cultura atual estiver definida como en-MX, o controle renderizará um arquivo de script que tenha um nome como scriptname.en-MX.debug.js, se o arquivo existir. Se o arquivo não existir, o arquivo de depuração para a cultura de fallback apropriada será renderizado

Para obter mais informações sobre como localizar recursos, consulte Visão geral da 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 é gerado. A maneira como os erros no servidor são enviados ao cliente depende da AllowCustomErrorsRedirect propriedade, da AsyncPostBackErrorMessage propriedade e da seção de erros personalizados do arquivo Web.config. Para obter mais informações, consulte Personalizando o tratamento de erros para controles UpdatePanel.

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

ScriptManager()

Inicializa uma nova instância da classe ScriptManager.

Propriedades

Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AjaxFrameworkAssembly	Obtém o assembly da estrutura Ajax que os componentes na página usam.
AjaxFrameworkMode	Obtém ou define um valor que especifica como os scripts do cliente da biblioteca de cliente do Microsoft Ajax serão incluídos no cliente.
AllowCustomErrorsRedirect	Obtém ou define um valor que determina se a seção de erros personalizados do arquivo Web.config é usada ou não durante um erro em um postback assíncrono.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
AsyncPostBackErrorMessage	Obtém ou define a mensagem de erro que é enviada ao cliente quando ocorre uma exceção sem tratamento do servidor durante um postback assíncrono.
AsyncPostBackSourceElementID	Obtém a ID exclusiva do controle que causou o postback assíncrono.
AsyncPostBackTimeout	Obtém ou define um valor que indica o tempo, em segundos, antes que o tempo limite de postbacks assíncronos seja atingido, se nenhuma resposta é recebida.
AuthenticationService	Obtém o objeto AuthenticationServiceManager associado à instância ScriptManager atual.
BindingContainer	Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control)
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
ClientNavigateHandler	Obtém ou define o nome do método que manipula o evento Sys.Application.navigate no cliente.
CompositeScript	Obtém uma referência ao script de composição que dá suporte à página da Web.
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Control)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
EmptyPageUrl	Obtém ou define uma URL para uma página da Web em branco.
EnableCdn	Determina se a página atual carrega as referências de script de cliente de caminhos de CDN (Rede de Distribuição de Conteúdo).
EnableCdnFallback	Permite que uma cópia local de um script seja carregada caso a CDN (Rede de Distribuição de Conteúdo) esteja indisponível.
EnableHistory	Obtém ou define um valor que indica se a página da Web dá suporte ao gerenciamento de ponto histórico.
EnablePageMethods	Obtém ou define um valor que indica se os métodos de página estática pública em uma página do ASP.NET podem ser chamados por meio do script de cliente.
EnablePartialRendering	Obtém ou define um valor que permite a renderização parcial de uma página, o que por sua vez permite que você atualize regiões da página individualmente usando controles UpdatePanel.
EnableScriptGlobalization	Obtém ou define um valor que indica se o controle ScriptManager renderiza um script que dá suporte à análise e formatação de informações específicas de cultura.
EnableScriptLocalization	Obtém ou define um valor que indica se o controle ScriptManager renderiza versões localizadas dos arquivos de script.
EnableSecureHistoryState	Obtém ou define um valor que indica se a cadeia de caracteres de estado histórico deve ser criptografada.
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de Control)
EnableViewState	Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
HasChildViewState	Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsDebuggingEnabled	Obtém um valor que indica se as versões de depuração das bibliotecas de script de cliente serão renderizadas.
IsInAsyncPostBack	Obtém um valor que indica se o postback atual está sendo executado no modo de renderização parcial.
IsNavigating	Obtém um valor que indica se um evento Navigate está sendo manipulado no momento.
IsTrackingViewState	Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LoadScriptsBeforeUI	Obtém ou define um valor que indica se os scripts são carregados antes ou depois da marcação da interface do usuário da página ser carregada.
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
ProfileService	Obtém o objeto ProfileServiceManager associado à instância ScriptManager atual.
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RoleService	Obtém o objeto RoleServiceManager associado à instância ScriptManager atual.
ScriptMode	Obtém ou define um valor que especifica se as versões de depuração ou lançamento das bibliotecas de script de cliente são renderizadas.
ScriptPath	Obsoleto. Obtém ou define o caminho raiz do local usado para criar os caminhos para arquivos de script personalizados e do ASP.NET Ajax.
ScriptResourceMapping	Obtém um objeto ScriptResourceMapping.
Scripts	Obtém um objeto ScriptReferenceCollection que contém os objetos ScriptReference, cada um dos quais representa um arquivo de script renderizado para o cliente.
Services	Obtém um objeto ServiceReferenceCollection que contém um objeto ServiceReference para cada serviço Web que o ASP.NET expõe no cliente para a funcionalidade do Ajax.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a capa a ser aplicada ao controle. (Herdado de Control)
SupportsPartialRendering	Obtém um valor que indica se o cliente dá suporte à renderização parcial da página.
TemplateControl	Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Substitui a propriedade Visible herdada da classe Control base para evitar a configuração desse valor.

Métodos

AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddHistoryPoint(NameValueCollection, String)	Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a coleta de dados de estado e o título do estado especificados.
AddHistoryPoint(String, String)	Cria um ponto histórico e o adiciona à pilha histórica do navegador, usando a chave e o valor de estado especificados.
AddHistoryPoint(String, String, String)	Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a chave, o valor e o título de estado especificados.
AddParsedSubObject(Object)	Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
CreateChildControls()	Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
DataBind()	Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles 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)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de Control)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para um controle. (Herdado de Control)
GetCurrent(Page)	Obtém a instância ScriptManager para um determinado objeto Page.
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRegisteredArrayDeclarations()	Recupera uma coleção somente leitura de declarações da matriz ECMAScript (JavaScript) que foram anteriormente registradas com o objeto Page.
GetRegisteredClientScriptBlocks()	Recupera uma coleção somente leitura de blocos de script de cliente que foram anteriormente registrados com o controle ScriptManager.
GetRegisteredDisposeScripts()	Recupera uma coleção somente leitura de scripts `dispose` que foram anteriormente registrados com o objeto Page.
GetRegisteredExpandoAttributes()	Recupera uma coleção somente leitura de atributos personalizados (expando) que foram anteriormente registrados com o objeto Page.
GetRegisteredHiddenFields()	Recupera uma coleção somente leitura de campos ocultos que foram anteriormente registrados com o objeto Page.
GetRegisteredOnSubmitStatements()	Recupera uma coleção somente leitura de instruções `onsubmit` que foram anteriormente registradas com o objeto Page.
GetRegisteredStartupScripts()	Recupera uma coleção somente leitura de scripts de inicialização que foram anteriormente registrados com o objeto Page.
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 a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetStateString()	Recupera uma cadeia de caracteres que contém pares chave-valor que representam o estado da página da Web.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control)
LoadPostData(String, NameValueCollection)	Lê dados de formulário publicados do navegador no servidor e determina a origem do postback assíncrono.
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState(). (Herdado de Control)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Aciona o evento AsyncPostBackError.
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnInit(EventArgs)	Gera o evento Init e garante que apenas um controle ScriptManager exista na página.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Gera o evento PreRender e registra arquivos de script e serviços para obter atualizações parciais da página.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Aciona o evento ResolveCompositeScriptReference.
OnResolveScriptReference(ScriptReferenceEventArgs)	Gera o evento ResolveScriptReference para cada referência de script gerenciada pelo controle ScriptManager.
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RaisePostBackEvent(String)	Processa um evento de postback gerado pelo controle ScriptManager e carrega o estado histórico da página da Web.
RaisePostDataChangedEvent()	Aciona eventos para o controle ScriptManager quando ele executa um postback para o servidor.
RegisterArrayDeclaration(Control, String, String)	Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à página.
RegisterArrayDeclaration(Page, String, String)	Registra uma declaração de matriz ECMAScript (JavaScript) no controle ScriptManager para uso com um controle que está dentro de um controle UpdatePanel e adiciona a matriz à página.
RegisterAsyncPostBackControl(Control)	Registra um controle como um gatilho para postbacks assíncronos.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Registra um bloco de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona o bloco de script à página.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Registra um bloco de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona o bloco de script à página.
RegisterClientScriptInclude(Control, Type, String, String)	Registra um arquivo de script de cliente com o controle ScriptManager para uso com um controle que está em um controle UpdatePanel e adiciona uma referência de arquivo de script à página.
RegisterClientScriptInclude(Page, Type, String, String)	Registra um script de cliente com o controle ScriptManager toda vez que um postback assíncrono ocorre e, em seguida, adiciona uma referência de arquivo de script à página.
RegisterClientScriptResource(Control, Type, String)	Registra o script de cliente inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da renderização parcial da página.
RegisterClientScriptResource(Page, Type, String)	Registra um arquivo de script de cliente inserido em um assembly com o controle ScriptManager sempre que um postback ocorre.
RegisterDataItem(Control, String)	Envia dados personalizados a um controle durante a renderização de página parcial.
RegisterDataItem(Control, String, Boolean)	Envia dados personalizados a um controle durante a renderização parcial da página e indica se os dados estão no formato JSON (JavaScript Object Notation).
RegisterDispose(Control, String)	Registra um script `dispose` para um controle que está em um controle UpdatePanel. O script é executado quando o controle UpdatePanel é atualizado ou excluído.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Registra um par nome-valor no controle ScriptManager como um atributo personalizado (expando) de um controle especificado.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registra um controle de extensão na instância ScriptManager atual.
RegisterHiddenField(Control, String, String)	Registra um campo oculto com o controle ScriptManager para um controle que está dentro de um controle UpdatePanel.
RegisterHiddenField(Page, String, String)	Registra um campo oculto com o controle ScriptManager durante cada postback assíncrono.
RegisterNamedClientScriptResource(Control, String)	Registra o script de cliente por nome de recurso inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da renderização parcial da página.
RegisterNamedClientScriptResource(Page, String)	Registra o script de cliente por nome de recurso inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da renderização parcial da página.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.
RegisterOnSubmitStatement(Page, Type, String, String)	Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.
RegisterPostBackControl(Control)	Registra um controle como um gatilho para um postback. Esse método é usado para configurar controles de postback dentro um controle UpdatePanel que executaria postbacks assíncronos.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registra um controle de script com a instância ScriptManager atual.
RegisterScriptDescriptors(IExtenderControl)	Retorna a chamada para uma classe ExtenderControl para retornar scripts de instância que devem ser renderizados para dar suporte ao objeto de cliente que representa um controle, componente ou comportamento de cliente.
RegisterScriptDescriptors(IScriptControl)	Chama uma classe ScriptControl para retornar scripts de instância que devem ser renderizados para dar suporte ao objeto de cliente que representa um controle, componente ou comportamento de cliente.
RegisterStartupScript(Control, Type, String, String, Boolean)	Registra um bloco de script de inicialização para um controle que está dentro de um UpdatePanel usando o controle ScriptManager e adiciona o bloco de script à página.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registra um bloco de script de inicialização para cada postback assíncrono com o controle ScriptManager e adiciona o bloco de script à página.
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o conteúdo do controle ScriptManager para o navegador usando o objeto HtmlTextWriter especificado.
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control)
SaveViewState()	Salva alterações de estado de exibição do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control)
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
SetFocus(Control)	Define o foco do navegador para o controle especificado.
SetFocus(String)	Define o foco do navegador como o controle especificado pela ID.
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. Esse objeto é acessível por meio da propriedade ViewState. (Herdado de Control)

Eventos

AsyncPostBackError	Ocorre quando há um erro de página durante um postback assíncrono.
DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
Navigate	Ocorre quando o usuário clica no botão Voltar ou Avançar do navegador.
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
ResolveCompositeScriptReference	Ocorre quando um script de composição está registrado com o controle ScriptManager.
ResolveScriptReference	Ocorre quando um membro da coleção Scripts está registrado com o controle ScriptManager.
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Para obter uma descrição desse membro, confira LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Para obter uma descrição desse membro, confira RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Permite que o controle ScriptManager processe um evento de postback e carregue o estado histórico da página da Web.

Métodos de Extensão

FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.

Aplica-se a

Compartilhar via