ScriptManager Classe
Definição
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 IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- Herança
- Atributos
- Implementações
Exemplos
Os exemplos a seguir mostram cenários diferentes para usar o ScriptManager controle .
Habilitando Partial-Page Atualizações
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
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 |
| 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 |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| 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 |
| 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 |
| 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 |
| 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
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
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de