ScriptManager Classe

Definição

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.Manages ASP.NET Ajax script libraries and script files, partial-page rendering, and client proxy class generation for Web and application services.

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
type ScriptManager = class
    inherit Control
    interface IPostBackDataHandler
    interface IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Herança
ScriptManager
Atributos
Implementações

Exemplos

Os exemplos a seguir mostram diferentes cenários para usar o controle de ScriptManager.The following examples show different scenarios for using the ScriptManager control.

Habilitando atualizações de página parcialEnabling Partial-Page Updates

O exemplo a seguir mostra como usar o controle de ScriptManager para habilitar atualizações parciais de página.The following example shows how to use the ScriptManager control to enable partial-page updates. Neste exemplo, um Calendar e um controle de DropDownList estão dentro de um controle de UpdatePanel.In this example, a Calendar and a DropDownList control are inside an UpdatePanel control. Por padrão, o valor da propriedade UpdateMode é Alwayse o valor da propriedade ChildrenAsTriggers é true.By default, the value of the UpdateMode property is Always, and the value of the ChildrenAsTriggers property is true. Portanto, os controles filho do painel causam um postback assíncrono.Therefore, child controls of the panel cause an asynchronous postback.


<%@ 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 de erros de atualização de página parcial e de registro de scriptHandling Partial-Page Update Errors and Registering Script

O exemplo a seguir mostra como fornecer tratamento de erro personalizado durante atualizações de página parcial.The following example shows how to provide custom error handling during partial-page updates. Por padrão, quando ocorre um erro durante atualizações de página parcial, uma caixa de mensagem JavaScript é exibida.By default, when an error occurs during partial-page updates, a JavaScript message box is displayed. Este exemplo demonstra como usar o tratamento de erros personalizado fornecendo um manipulador para o evento AsyncPostBackError e definindo a propriedade AsyncPostBackErrorMessage no manipulador de eventos.This example demonstrates how to use custom error handling by providing a handler for the AsyncPostBackError event, and by setting the AsyncPostBackErrorMessage property in the event handler. Você também pode definir a propriedade AllowCustomErrorsRedirect 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.You can also set the AllowCustomErrorsRedirect property to specify how the custom errors section of the Web.config file is used when an error occurs during partial-page updates. Neste exemplo, o valor padrão da propriedade AllowCustomErrorsRedirect é usado.In this example, the default value of the AllowCustomErrorsRedirect property is used. Isso significa que, se o arquivo Web. config contiver um elemento customErrors , esse elemento determinará como os erros são exibidos.This means that if the Web.config file contains a customErrors element, that element determines how errors are displayed. Para obter mais informações, consulte elemento customErrors (esquema de configurações do ASP.net).For more information, see 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>

Globalizando a data e hora que são exibidas no navegadorGlobalizing the Date and Time That Are Displayed in the Browser

O exemplo a seguir mostra como definir a propriedade EnableScriptGlobalization para que o script de cliente possa exibir uma data e hora específicas da cultura no navegador.The following example shows how to set the EnableScriptGlobalization property so that client script can display a culture-specific date and time in the browser. No exemplo, o atributo Culture da diretiva @ Page é definido como auto.In the example, the Culture attribute of the @ Page directive is set to auto. 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.As a result, the first language that is specified in the current browser settings determines the culture and UI culture for the page. Para obter mais informações, consulte como: definir a cultura e a cultura da interface do usuário para globalização de página da Web ASP.net.For more information, see How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.

<%@ 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:In this topic:

IntroduçãoIntroduction

O controle de ScriptManager é fundamental para a funcionalidade Ajax no ASP.NET.The ScriptManager control is central to Ajax functionality in ASP.NET. O controle gerencia todos os recursos do ASP.NET AJAX em uma página.The control manages all ASP.NET Ajax resources on a page. Isso inclui baixar scripts da biblioteca do Microsoft Ajax para o navegador e coordenar atualizações de página parcial que são habilitadas usando controles de UpdatePanel.This includes downloading Microsoft Ajax Library scripts to the browser and coordinating partial-page updates that are enabled by using UpdatePanel controls. Além disso, o controle ScriptManager permite que você faça o seguinte:In addition, the ScriptManager control enables you to do the following:

  • Registre o script que é compatível com atualizações de página parcial.Register script that is compatible with partial-page updates. Para gerenciar as dependências entre o script e a biblioteca principal, qualquer script registrado é carregado após o script da biblioteca do Microsoft Ajax.In order to manage dependencies between your script and the core library, any script that you register is loaded after the Microsoft Ajax Library script.

  • Especifique se os scripts de versão ou de depuração são enviados para o navegador.Specify whether release or debug scripts are sent to the browser.

  • Forneça acesso a métodos de serviço Web do script registrando serviços Web com o controle de ScriptManager.Provide access to Web service methods from script by registering Web services with the ScriptManager control.

  • Forneça acesso aos serviços de aplicativo de autenticação, função e perfil do ASP.NET do script de cliente registrando esses serviços com o controle de ScriptManager.Provide access to ASP.NET authentication, role, and profile application services from client script by registering these services with the ScriptManager control.

  • Habilite a exibição específica de cultura das funções de Data, númeroe cadeia de caracteres ECMAScript (JavaScript) no navegador.Enable culture-specific display of ECMAScript (JavaScript) Date, Number, and String functions in the browser.

  • Acesse recursos de localização para arquivos de script inseridos ou para arquivos de script autônomos usando a propriedade ResourceUICultures do controle de ScriptReference.Access localization resources for embedded script files or for stand-alone script files by using the ResourceUICultures property of the ScriptReference control.

  • Registre os controles de servidor que implementam as interfaces IExtenderControl ou IScriptControl com o controle de ScriptManager para que o script exigido pelos comportamentos e componentes cliente seja renderizado.Register server controls that implement the IExtenderControl or IScriptControl interfaces with the ScriptManager control so that script required by client components and behaviors is rendered.

Renderização de página parcialPartial-Page Rendering

A capacidade de uma página ASP.NET de dar suporte à renderização parcial da página é controlada pelos seguintes fatores:The ability of an ASP.NET page to support partial-page rendering is controlled by the following factors:

Você pode substituir o valor da propriedade EnablePartialRendering em tempo de execução durante ou antes do evento de Init da página.You can override the value of the EnablePartialRendering property at run time during or before the page's Init event. Se você tentar alterar essa propriedade depois que o evento de Init da página tiver ocorrido, uma exceção de InvalidOperationException será lançada.If you try to change this property after the page's Init event has occurred, an InvalidOperationException exception is thrown.

Quando há suporte para a renderização de página parcial, o controle de ScriptManager processa o script para habilitar postbacks assíncronos e atualizações de página parcial.When partial-page rendering is supported, the ScriptManager control renders script to enable asynchronous postbacks and partial-page updates. As regiões da página a ser atualizada são designadas usando controles de UpdatePanel.The regions of the page to be updated are designated by using UpdatePanel controls. O controle de ScriptManager lida com os postbacks assíncronos e atualiza apenas as regiões da página que precisam ser atualizadas.The ScriptManager control handles the asynchronous postbacks and refreshes only the regions of the page that have to be updated. Para obter mais informações sobre renderização de página parcial, consulte visão geral de renderização de página parcial.For more information about partial-page rendering, see Partial-Page Rendering Overview. Para obter mais informações sobre as condições que causam uma atualização, consulte visão geral do controle UpdatePanel.For more information about the conditions that cause an update, see UpdatePanel Control Overview.

Usando o controle ScriptManager com páginas mestre, controles de usuário e outros componentes filhoUsing the ScriptManager Control with Master Pages, User Controls, and Other Child Components

Uma página pode conter apenas um controle ScriptManager em sua hierarquia.A page can contain only one ScriptManager control in its hierarchy. Para registrar serviços e scripts para páginas aninhadas, controles de usuário ou componentes quando a página pai já tiver um controle de ScriptManager, use o controle ScriptManagerProxy.To register services and scripts for nested pages, user controls, or components when the parent page already has a ScriptManager control, use the ScriptManagerProxy control. Para obter mais informações, consulte usando o controle UpdatePanel com páginas mestras.For more information, see Using the UpdatePanel Control with Master Pages.

Gerenciamento e registro de scriptScript Management and Registration

O controle ScriptManager permite que você registre o script que é processado como parte da página.The ScriptManager control enables you to register script that is then rendered as part of the page. Os métodos de registro de controle de ScriptManager podem ser divididos nas três categorias a seguir:The ScriptManager control registration methods can be broken into the following three categories:

  • Os métodos de registro que garantem que as dependências de script na biblioteca do Microsoft Ajax sejam mantidos.Registration methods that guarantee that script dependencies on the Microsoft Ajax Library are maintained.

  • Métodos de registro que não são dependentes da biblioteca do Microsoft Ajax, mas que são compatíveis com controles de UpdatePanel.Registration methods that are not dependent on the Microsoft Ajax Library, but that are compatible with UpdatePanel controls.

  • Métodos de registro que dão suporte ao trabalho com controles de UpdatePanel.Registration methods that support working with UpdatePanel controls.

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.For more information about how to create and use Ajax script in ASP.NET, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Registrando o script que depende da Microsoft Ajax LibraryRegistering Script That Is Dependent on the Microsoft Ajax Library

Você pode usar os métodos a seguir para registrar arquivos de script de uma maneira que garanta que todas as dependências na biblioteca do Microsoft Ajax sejam mantidas.You can use the following methods to register script files in a way that guarantees that any dependencies on the Microsoft Ajax Library are maintained.

MétodoMethod DefiniçãoDefinition
RegisterScriptControl Registra um controle de servidor que implementa a interface IScriptControl que é usada para definir um objeto de cliente Sys. Component .Registers a server control that implements the IScriptControl interface that is used to define a Sys.Component client object. O controle de ScriptManager processa o script que dá suporte ao objeto de cliente.The ScriptManager control renders script that supports the client object.
RegisterExtenderControl Registra um controle de servidor que implementa a interface IExtenderControl que é usada para definir um objeto de cliente Sys. Component .Registers a server control that implements the IExtenderControl interface that is used to define a Sys.Component client object. O controle de ScriptManager processa o script que dá suporte ao objeto de cliente.The ScriptManager control renders script that supports the client object.

Registrando scripts compatíveis com atualização de página parcialRegistering Partial-Page Update Compatible Scripts

Você pode usar os seguintes métodos para registrar arquivos de script que não dependem da biblioteca do Microsoft Ajax, mas que são compatíveis com os controles de UpdatePanel.You can use the following methods to register script files that are not dependent on the Microsoft Ajax Library but that are compatible with UpdatePanel controls. Esses métodos correspondem a métodos semelhantes do controle de ClientScriptManager.These methods correspond to similar methods of the ClientScriptManager control. Se você estiver renderizando o script para uso dentro de um controle de UpdatePanel, certifique-se de chamar os métodos do controle ScriptManager.If you are rendering script for use inside an UpdatePanel control, make sure that you call the methods of the ScriptManager control.

MétodoMethod DefiniçãoDefinition
RegisterArrayDeclaration Adiciona um valor a uma matriz JavaScript.Adds a value to a JavaScript array. Se a matriz não existir, ela será criada.If the array does not exist, it is created.
RegisterClientScriptBlock Renderiza um elemento script após a marcação de <form> de abertura da página.Renders a script element after the page's opening <form> tag. O script é especificado como um parâmetro de cadeia de caracteres.The script is specified as a string parameter.
RegisterClientScriptInclude Renderiza um elemento script após a marcação de <form> de abertura da página.Renders a script element after the page's opening <form> tag. O conteúdo do script é especificado definindo o atributo src como uma URL que aponta para um arquivo de script.The script content is specified by setting the src attribute to a URL that points to a script file.
RegisterClientScriptResource Renderiza um elemento script após a marcação de <form> de abertura da página.Renders a script element after the page's opening <form> tag. O conteúdo do script é especificado com um nome de recurso em um assembly.The script content is specified with a resource name in an assembly. O atributo src é preenchido automaticamente com uma URL por uma chamada para um manipulador HTTP que recupera o script nomeado do assembly.The src attribute is automatically populated with a URL by a call to an HTTP handler that retrieves the named script from the assembly.
RegisterExpandoAttribute Renderiza um par de atributos de nome/valor personalizado (um expando) na marcação para um controle especificado.Renders a custom name/value attribute pair (an expando) in the markup for a specified control.
RegisterHiddenField Renderiza um campo oculto.Renders a hidden field.
RegisterOnSubmitStatement Registra um script que é executado em resposta ao evento de submit do elemento de form.Registers a script that is executed in response to the form element's submit event. O atributo onSubmit referencia o script especificado.The onSubmit attribute references the specified script.
RegisterStartupScript Renderiza um bloco de script de inicialização logo antes da marca de </form> de fechamento da página.Renders a startup script block just before the page's closing </form> tag. O script a ser renderizado é especificado como um parâmetro de cadeia de caracteres.The script to render is specified as a string parameter.

Ao registrar métodos, você especifica um par de tipo/chave para esse script.When you register methods, you specify a type/key pair for that script. Se um script com o mesmo tipo/par de chaves já estiver registrado, um novo script não será registrado.If a script with the same type/key pair is already registered, a new script is not registered. Da mesma forma, se você registrar um script com um par de nome de tipo/recurso que já existe, o elemento script que faz referência ao recurso não será adicionado novamente.Similarly, if you register a script with a type/resource name pair that already exists, the script element that references the resource is not added again. Quando você registra um atributo expando de um atributo previamente registrado, uma exceção é lançada.When you register an expando attribute of a previously registered attribute, an exception is thrown. É permitido o registro duplicado de valores de matriz.Duplicate registration of array values is allowed.

Quando você chama o RegisterClientScriptInclude ou o método RegisterClientScriptResource, evite registrar o script que executa funções embutidas.When you call the RegisterClientScriptInclude or the RegisterClientScriptResource method, avoid registering script that executes inline functions. 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.Instead, register script that contains function definitions like event handlers or custom class definitions for your application.

Métodos de registro para controle UpdatePanelRegistration Methods for UpdatePanel Controls

Você pode usar os métodos a seguir para personalizar atualizações de página parcial ao usar controles de UpdatePanel.You can use the following methods to customize partial-page updates when you use UpdatePanel controls.

MétodoMethod DefiniçãoDefinition
RegisterAsyncPostBackControl Registra um controle como um gatilho para postbacks assíncronos.Registers a control as a trigger for asynchronous postbacks.
RegisterDataItem Envia dados personalizados para controles durante a renderização parcial da página.Sends custom data to controls during partial-page rendering.
RegisterDispose Registra um script Dispose para um controle que está dentro de um controle de UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. O script é executado quando o controle UpdatePanel é atualizado ou excluído.The script is executed when the UpdatePanel control is updated or deleted. O método Dispose é usado para componentes cliente que fazem parte da biblioteca do Microsoft Ajax e que precisam liberar recursos quando um componente não é mais usado.The dispose method is used for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.
RegisterPostBackControl Registra um controle como um gatilho para um postback completo.Registers a control as a trigger for a full postback. Esse método é usado para controles dentro de um controle de UpdatePanel que, de outra forma, executa postbacks assíncronos.This method is used for controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

Referências de serviço WebWeb Service References

Você pode registrar um serviço Web a ser chamado do script de cliente criando um objeto de ServiceReference e adicionando-o à coleção de Services do controle de ScriptManager.You can register a Web service to be called from client script by creating a ServiceReference object and adding it to the Services collection of the ScriptManager control. ASP.NET gera um objeto de proxy de cliente para cada objeto de ServiceReference na coleção de Services.ASP.NET generates a client proxy object for each ServiceReference object in the Services collection. Você pode adicionar de forma programática ServiceReference objetos à coleção de Services para registrar serviços Web em tempo de execução.You can programmatically add ServiceReference objects to the Services collection to register Web services at run time.

Para obter mais informações sobre como acessar os serviços Web no script, consulte expondo serviços Web ao script de cliente no ASP.NET AJAX e chamando serviços Web do script de cliente no ASP.NET AJAX.For more information about how to access Web services in script, see Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

LocalizaçãoLocalization

O controle ScriptManager gera referências na página renderizada que aponta para os arquivos de script localizados apropriados, que são arquivos de script inseridos em assemblies ou arquivos de script autônomos.The ScriptManager control generates references in the rendered page that point to the appropriate localized script files, which are either script files embedded in assemblies or stand-alone script files.

Quando a propriedade EnableScriptLocalization é definida como true, o controle de ScriptManager recupera recursos localizados (como cadeias de caracteres localizadas) para a cultura atual, se existirem.When the EnableScriptLocalization property is set to true, the ScriptManager control retrieves localized resources (such as localized strings) for the current culture, if they exist. O controle ScriptManager fornece a seguinte funcionalidade para usar recursos localizados:The ScriptManager control provides the following functionality for using localized resources:

  • Arquivos de script inseridos em um assembly.Script files that are embedded in an assembly. O controle ScriptManager determina qual arquivo de script específico de cultura ou cultura de fallback para enviar ao navegador.The ScriptManager control determines which culture-specific or fallback-culture script file to send to the browser. Ele faz isso usando o atributo assembly NeutralResourcesLanguageAttribute específico da cultura, os recursos empacotados com o assembly e a cultura da interface do usuário do navegador (se houver).It does this by using the culture-specific NeutralResourcesLanguageAttribute assembly attribute, the resources packaged with the assembly, and the UI culture of the browser (if any).

  • Arquivos de scriptautônomos.Stand-alone script files. O controle ScriptManager define a lista de culturas de interface do usuário com suporte usando a propriedade ResourceUICultures do objeto ScriptReference.The ScriptManager control defines the list of UI cultures that are supported by using the ResourceUICultures property of the ScriptReference object.

  • No modo de depuração.In debug mode. O controle de ScriptManager tenta renderizar um arquivo de script específico de cultura que contém informações de depuração.The ScriptManager control tries to render a culture-specific script file that contains debug information. 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 tem um nome como scriptname. en-MX. Debug. js, se o arquivo existir.For example, if the page is in debug mode and the current culture is set to en-MX, the control renders a script file that has a name such as scriptname.en-MX.debug.js, if the file exists. Se o arquivo não existir, o arquivo de depuração para a cultura de fallback apropriada será renderizadoIf the file does not exist, the debug file for the appropriate fallback culture is rendered

Para obter mais informações sobre como localizar recursos, consulte localizando recursos para bibliotecas de componentes visão geral.For more information about how to localize resources, see Localizing Resources for Component Libraries Overview.

Tratamento de errosError Handling

Quando ocorre um erro de página durante postbacks assíncronos, o evento AsyncPostBackError é gerado.When a page error occurs during asynchronous postbacks, the AsyncPostBackError event is raised. A maneira como os erros no servidor são enviados ao cliente depende da propriedade AllowCustomErrorsRedirect, da propriedade AsyncPostBackErrorMessage e da seção de erros personalizados do arquivo Web. config.The way in which errors on the server are sent to the client depends on the AllowCustomErrorsRedirect property, the AsyncPostBackErrorMessage property, and the custom errors section of the Web.config file. Para obter mais informações, consulte Personalizando o tratamento de erros para controles UpdatePanel.For more information, see Customizing Error Handling for UpdatePanel Controls.

Sintaxe declarativaDeclarative Syntax

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

Inicia uma nova instância da classe ScriptManager.Initializes a new instance of the ScriptManager class.

Propriedades

Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(Herdado de Control)
AjaxFrameworkAssembly

Obtém o assembly da estrutura Ajax que os componentes na página usam.Gets the Ajax framework assembly that components on the page use.

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.Gets or sets a value that specifies how client scripts of the Microsoft Ajax client library will be included on the client.

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.Gets or sets a value that determines whether the custom errors section of the Web.config file is used during an error in an asynchronous postback.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(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.Gets or sets the error message that is sent to the client when an unhandled server exception occurs during an asynchronous postback.

AsyncPostBackSourceElementID

Obtém a ID exclusiva do controle que causou o postback assíncrono.Gets the unique ID of the control that caused the asynchronous postback.

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.Gets or sets a value that indicates the time, in seconds, before asynchronous postbacks time out if no response is received.

AuthenticationService

Obtém o objeto AuthenticationServiceManager associado à instância ScriptManager atual.Gets the AuthenticationServiceManager object that is associated with the current ScriptManager instance.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

(Herdado de Control)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

(Herdado de Control)
ClientNavigateHandler

Obtém ou define o nome do método que manipula o evento Sys.Application.navigate no cliente.Gets or sets the name of the method that handles the Sys.Application.navigate event on the client.

CompositeScript

Obtém uma referência ao script de composição que dá suporte à página da Web.Gets a reference to the composite script that supports the Web page.

Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Herdado de Control)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Herdado de Control)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
EmptyPageUrl

Obtém ou define uma URL para uma página da Web em branco.Gets or sets a URL to a blank Web page.

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).Determines whether the current page loads client script references from CDN (Content Delivery Network) paths.

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.Enables local copy of a script to load in the event that the CDN (Content Delivery Network) is unavailable.

EnableHistory

Obtém ou define um valor que indica se a página da Web dá suporte ao gerenciamento de ponto histórico.Gets or sets a value that indicates whether the Web page supports history point management.

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.Gets or sets a value that indicates whether public static page methods in an ASP.NET page can be called from client script.

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.Gets or sets a value that enables partial rendering of a page, which in turn enables you to update regions of the page individually by using UpdatePanel controls.

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.Gets or sets a value that indicates whether the ScriptManager control renders script that supports parsing and formatting of culture-specific information.

EnableScriptLocalization

Obtém ou define um valor que indica se o controle ScriptManager renderiza versões localizadas dos arquivos de script.Gets or sets a value that indicates whether the ScriptManager control renders localized versions of script files.

EnableSecureHistoryState

Obtém ou define um valor que indica se a cadeia de caracteres de estado histórico deve ser criptografada.Gets or sets a value that indicates whether to encrypt the history state string.

EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control.

(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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Esta propriedade é somente para leitura.This property is read-only.

(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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(Herdado de Control)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(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.Gets a value that indicates whether the debug versions of client script libraries will be rendered.

IsInAsyncPostBack

Obtém um valor que indica se o postback atual está sendo executado no modo de renderização parcial.Gets a value that indicates whether the current postback is being executed in partial-rendering mode.

IsNavigating

Obtém um valor que indica se um evento Navigate está sendo manipulado no momento.Gets a value that indicates whether a Navigate event is currently being handled.

IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

(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.Gets or sets a value that indicates whether scripts are loaded before or after markup for the page UI is loaded.

LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(Herdado de Control)
ProfileService

Obtém o objeto ProfileServiceManager associado à instância ScriptManager atual.Gets the ProfileServiceManager object that is associated with the current ScriptManager instance.

RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Herdado de Control)
RoleService

Obtém o objeto RoleServiceManager associado à instância ScriptManager atual.Gets the RoleServiceManager object that is associated with the current ScriptManager instance.

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.Gets or sets a value that specifies whether debug or release versions of client script libraries are rendered.

ScriptPath

Obtém ou define o caminho raiz do local usado para criar os caminhos para arquivos de script personalizados e do ASP.NET Ajax.Gets or sets the root path of the location that is used to build the paths to ASP.NET Ajax and custom script files.

ScriptResourceMapping

Obtém um objeto ScriptResourceMapping.Gets a ScriptResourceMapping object.

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.Gets a ScriptReferenceCollection object that contains the ScriptReference objects, each of which represents a script file rendered to the client.

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.Gets a ServiceReferenceCollection object that contains a ServiceReference object for each Web service that ASP.NET exposes on the client for Ajax functionality.

Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control.

(Herdado de Control)
SupportsPartialRendering

Obtém um valor que indica se o cliente dá suporte à renderização parcial da página.Gets a value that indicates whether the client supports partial-page rendering.

TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(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.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Substitui a propriedade Visible herdada da classe Control base para evitar a configuração desse valor.Overrides the Visible property that is inherited from the base Control class to prevent setting this value.

Métodos

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

(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.Creates a history point and adds it to the browser's history stack, using the specified state data collection and state title.

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.Creates a history point and adds it to the browser's history stack, using the specified state key and state value.

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.Creates a history point and adds it to the browser's history stack, using the specified state key, state value, and state title.

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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Herdado de Control)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

(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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(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.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Herdado de Control)
CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Herdado de Control)
DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls.

(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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(Herdado de Control)
Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.Sets input focus to a control.

(Herdado de Control)
GetCurrent(Page)

Obtém a instância ScriptManager para um determinado objeto Page.Gets the ScriptManager instance for a given Page object.

GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(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.Retrieves a read-only collection of ECMAScript (JavaScript) array declarations that were previously registered with the Page object.

GetRegisteredClientScriptBlocks()

Recupera uma coleção somente leitura de blocos de script de cliente que foram anteriormente registrados com o controle ScriptManager.Retrieves a read-only collection of client script blocks that were previously registered with the ScriptManager control.

GetRegisteredDisposeScripts()

Recupera uma coleção somente leitura de scripts dispose que foram anteriormente registrados com o objeto Page.Retrieves a read-only collection of dispose scripts that were previously registered with the Page object.

GetRegisteredExpandoAttributes()

Recupera uma coleção somente leitura de atributos personalizados (expando) que foram anteriormente registrados com o objeto Page.Retrieves a read-only collection of custom (expando) attributes that were previously registered with the Page object.

GetRegisteredHiddenFields()

Recupera uma coleção somente leitura de campos ocultos que foram anteriormente registrados com o objeto Page.Retrieves a read-only collection of hidden fields that were previously registered with the Page object.

GetRegisteredOnSubmitStatements()

Recupera uma coleção somente leitura de instruções onsubmit que foram anteriormente registradas com o objeto Page.Retrieves a read-only collection of onsubmit statements that were previously registered with the Page object.

GetRegisteredStartupScripts()

Recupera uma coleção somente leitura de scripts de inicialização que foram anteriormente registrados com o objeto Page.Retrieves a read-only collection of startup scripts that were previously registered with the Page object.

GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetStateString()

Recupera uma cadeia de caracteres que contém pares chave-valor que representam o estado da página da Web.Retrieves a string that contains key/value pairs that represent the state of the Web page.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(Herdado de Control)
IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(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().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Herdado de Control)
LoadPostData(String, NameValueCollection)

Lê dados de formulário publicados do navegador no servidor e determina a origem do postback assíncrono.Reads form data that is posted from the browser to the server, and determines the source of the asynchronous postback.

LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Herdado de Control)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Gera o evento AsyncPostBackError.Raises the AsyncPostBackError event.

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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Herdado de Control)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.Raises the DataBinding event.

(Herdado de Control)
OnInit(EventArgs)

Gera o evento Init e garante que apenas um controle ScriptManager exista na página.Raises the Init event and makes sure that only one ScriptManager control exists on the page.

OnLoad(EventArgs)

Aciona o evento Load.Raises the Load event.

(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.Raises the PreRender event, and registers script files and services for partial-page updates.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Gera o evento ResolveCompositeScriptReference.Raises the ResolveCompositeScriptReference event.

OnResolveScriptReference(ScriptReferenceEventArgs)

Gera o evento ResolveScriptReference para cada referência de script gerenciada pelo controle ScriptManager.Raises the ResolveScriptReference event for each script reference that is managed by the ScriptManager control.

OnUnload(EventArgs)

Aciona o evento Unload.Raises the Unload event.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(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.Processes a postback event raised by the ScriptManager control and loads the history state of the Web page.

RaisePostDataChangedEvent()

Aciona eventos para o controle ScriptManager quando ele executa um postback para o servidor.Raises events for the ScriptManager control when it posts back to the server.

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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterAsyncPostBackControl(Control)

Registra um controle como um gatilho para postbacks assíncronos.Registers a control as a trigger for asynchronous postbacks.

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.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

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.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

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.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

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.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the page.

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.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterClientScriptResource(Page, Type, String)

Registra um arquivo de script de cliente inserido em um assembly com o controle ScriptManager sempre que um postback ocorre.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterDataItem(Control, String)

Envia dados personalizados a um controle durante a renderização de página parcial.Sends custom data to a control during partial-page rendering.

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).Sends custom data to a control during partial-page rendering, and indicates whether the data is in JavaScript Object Notation (JSON) format.

RegisterDispose(Control, String)

Registra um script dispose para um controle que está em um controle UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. O script é executado quando o controle UpdatePanel é atualizado ou excluído.The script is executed when the UpdatePanel control is updated or deleted.

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

Registra um par nome-valor no controle ScriptManager como um atributo personalizado (expando) de um controle especificado.Registers a name/value pair with the ScriptManager control as a custom (expando) attribute of a specified control.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registra um controle de extensão na instância ScriptManager atual.Registers an extender control with the current ScriptManager instance.

RegisterHiddenField(Control, String, String)

Registra um campo oculto com o controle ScriptManager para um controle que está dentro de um controle UpdatePanel.Registers a hidden field with the ScriptManager control for a control that is inside an UpdatePanel control.

RegisterHiddenField(Page, String, String)

Registra um campo oculto com o controle ScriptManager durante cada postback assíncrono.Registers a hidden field with the ScriptManager control during every asynchronous postback.

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.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

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.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterPostBackControl(Control)

Registra um controle como um gatilho para um postback.Registers a control as a trigger for a postback. Esse método é usado para configurar controles de postback dentro um controle UpdatePanel que executaria postbacks assíncronos.This method is used to configure postback controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

RegisterScriptControl<TScriptControl>(TScriptControl)

Registra um controle de script com a instância ScriptManager atual.Registers a script control with the current ScriptManager instance.

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.Calls back to an ExtenderControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

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.Calls a ScriptControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

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.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

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.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Renderiza o conteúdo do controle ScriptManager para o navegador usando o objeto HtmlTextWriter especificado.Renders the ScriptManager control's content to the browser by using the specified HtmlTextWriter object.

RenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(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.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Herdado de Control)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

(Herdado de Control)
SetFocus(Control)

Define o foco do navegador para o controle especificado.Sets the browser focus to the specified control.

SetFocus(String)

Define o foco do navegador como o controle especificado pela ID.Sets the browser focus to the control specified by ID.

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control.

(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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(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.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Esse objeto é acessível por meio da propriedade ViewState.This object is accessible through the ViewState property.

(Herdado de Control)

Eventos

AsyncPostBackError

Ocorre quando há um erro de página durante um postback assíncrono.Occurs when there is a page error during an asynchronous postback.

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
Navigate

Ocorre quando o usuário clica no botão Voltar ou Avançar do navegador.Occurs when the user clicks the browser's Back or Forward button.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
ResolveCompositeScriptReference

Ocorre quando um script de composição está registrado com o controle ScriptManager.Occurs when a composite script is registered with the ScriptManager control.

ResolveScriptReference

Ocorre quando um membro da coleção Scripts está registrado com o controle ScriptManager.Occurs when a member of the Scripts collection is registered with the ScriptManager control.

Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Para obter uma descrição desse membro, consulte LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Para obter uma descrição desse membro, consulte RaisePostDataChangedEvent().For a description of this member, see 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.Enables the ScriptManager control to process a postback event and load the history state of the Web page.

IScriptManager.IsSecureConnection
IScriptManager.RegisterArrayDeclaration(Control, String, String)
IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean)
IScriptManager.RegisterClientScriptInclude(Control, Type, String, String)
IScriptManager.RegisterClientScriptResource(Control, Type, String)
IScriptManager.RegisterDispose(Control, String)
IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean)
IScriptManager.RegisterHiddenField(Control, String, String)
IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String)
IScriptManager.RegisterPostBackControl(Control)
IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean)
IScriptManager.SetFocusInternal(String)

Métodos de Extensão

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

Aplica-se a

Veja também