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 ASP.NET bibliotecas de script e arquivos de script do Ajax, renderização de página parcial e geração de classe proxy do cliente para serviços Web e de aplicativos.
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 atualizações de Partial-Page
O exemplo a seguir mostra como usar o ScriptManager controle para habilitar atualizações de página parcial. Neste exemplo, um controle e DropDownList um Calendar controle estão dentro de um UpdatePanel controle. Por padrão, o valor da UpdateMode propriedade é Always, e 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>
Manipulando erros de atualização de Partial-Page e registrando script
O exemplo a seguir mostra como fornecer tratamento de erros personalizados 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 são exibidos. Para obter mais informações, consulte o elemento customErrors (esquema de configurações de 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 como 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. Para obter mais informações, consulte Como definir a cultura e a cultura da interface do usuário para ASP.NET Globalização da 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:
Usando o controle ScriptManager com páginas mestras, controles de usuário e outros componentes filho
Introdução
O ScriptManager controle é central para a funcionalidade do Ajax no ASP.NET. O controle gerencia todos os recursos do Ajax ASP.NET 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 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 do script do cliente registrando esses serviços com o ScriptManager controle.
Habilite a exibição específica da cultura das funções Data, Número e Cadeia de Caracteres do ECMAScript (JavaScript) no navegador.
Acesse os 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 ou IExtenderControlIScriptControl interfaces com o controle para que o ScriptManager script exigido pelos componentes e comportamentos do cliente seja renderizado.
renderização Partial-Page
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 a renderização de página parcial, consulte Partial-Page Visão geral da renderização. Para obter mais informações sobre as condições que causam uma atualização, consulte a Visão geral do controle UpdatePanel.
Usando o controle ScriptManager com páginas mestras, 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 Como usar 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 Microsoft Ajax sejam mantidas.
Métodos de registro que não dependem da Biblioteca 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 do Ajax em ASP.NET, consulte Criando script de cliente personalizado usando a Biblioteca do Microsoft Ajax.
Registrando script que depende da biblioteca do Microsoft Ajax
Você pode usar os métodos a seguir para registrar arquivos de script de uma maneira que garanta que quaisquer dependências na Biblioteca 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 a atualização de Partial-Page
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, certifique-se de chamar 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, especifique um par de tipo/chave para esse script. Se um script com o mesmo par tipo/chave 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 método ou o RegisterClientScriptIncludeRegisterClientScriptResource método, 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 controles 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 de página parcial. |
| RegisterDispose | Registra um script de descarte para um controle que está dentro de um UpdatePanel controle. O script é executado quando o UpdatePanel controle é atualizado ou excluído. O método de descarte é 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, executariam 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 os Serviços Web ao Script do Cliente no ASP.NET AJAX e Chamando Serviços Web do Script do Cliente no AJAX ASP.NET.
Localization
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 como true, 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 ou de cultura de fallback deve ser enviado para o navegador. Ele faz isso usando o atributo de assembly específico NeutralResourcesLanguageAttribute à 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 à 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 da 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
| Nome | Description |
|---|---|
| ScriptManager() |
Inicializa uma nova instância da classe ScriptManager. |
Propriedades
| Nome | Description |
|---|---|
| Adapter |
Obtém o adaptador específico do navegador para o controle. (Herdado de Control) |
| AjaxFrameworkAssembly |
Obtém o assembly da estrutura do Ajax que os componentes na página usam. |
| AjaxFrameworkMode |
Obtém ou define um valor que especifica como os scripts de cliente da biblioteca de clientes 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 durante um erro em um postback assíncrono. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control) |
| AsyncPostBackErrorMessage |
Obtém ou define a mensagem de erro enviada ao cliente quando ocorre uma exceção de servidor sem tratamento 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 de postbacks assíncronos atingirem o tempo limite se nenhuma resposta for recebida. |
| AuthenticationService |
Obtém o AuthenticationServiceManager objeto associado à instância atual ScriptManager . |
| BindingContainer |
Obtém o controle que contém a associação de dados desse controle. (Herdado de Control) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (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 composto que dá suporte à página da Web. |
| Context |
Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de Control) |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar 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 como uma página da Web em branco. |
| EnableCdn |
Determina se a página atual carrega referências de script do cliente de caminhos CDN (Rede de Distribuição de Conteúdo). |
| EnableCdnFallback |
Permite que a cópia local de um script seja carregada caso a CDN (Rede de Distribuição de Conteúdo) não esteja disponível. |
| EnableHistory |
Obtém ou define um valor que indica se a página da Web dá suporte ao gerenciamento de ponto de 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 ASP.NET podem ser chamados do script do 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 UpdatePanel controles. |
| EnableScriptGlobalization |
Obtém ou define um valor que indica se o controle renderiza o ScriptManager script que dá suporte à análise e à formatação de informações específicas da cultura. |
| EnableScriptLocalization |
Obtém ou define um valor que indica se o ScriptManager controle renderiza versões localizadas de arquivos de script. |
| EnableSecureHistoryState |
Obtém ou define um valor que indica se a cadeia de caracteres de estado de 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 do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de representantes do 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 do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle do 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 nesse 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 do 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 Navigate evento está sendo tratado no momento. |
| IsTrackingViewState |
Obtém um valor que indica se o controle do servidor está salvando alterações em seu 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 é carregada. |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control) |
| ProfileService |
Obtém o ProfileServiceManager objeto associado à instância atual ScriptManager . |
| RenderingCompatibility |
Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RoleService |
Obtém o RoleServiceManager objeto associado à instância atual ScriptManager . |
| ScriptMode |
Obtém ou define um valor que especifica se as versões de depuração ou versão de bibliotecas de script do cliente são renderizadas. |
| ScriptPath |
Obsoleto.
Obtém ou define o caminho raiz do local que é usado para criar os caminhos para ASP.NET arquivos de script personalizados e Ajax. |
| ScriptResourceMapping |
Obtém um ScriptResourceMapping objeto. |
| Scripts |
Obtém um ScriptReferenceCollection objeto que contém os ScriptReference objetos, cada um deles representa um arquivo de script renderizado para o cliente. |
| Services |
Obtém um ServiceReferenceCollection objeto que contém um ServiceReference objeto para cada serviço Web que 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 renderizado em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a pele a ser aplicada ao controle. (Herdado de Control) |
| SupportsPartialRendering |
Obtém um valor que indica se o cliente dá suporte à renderização de página parcial. |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control) |
| UniqueID |
Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de 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 StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control) |
| Visible |
Substitui a Visible propriedade herdada da classe base Control para impedir a definição desse valor. |
Métodos
| Nome | Description |
|---|---|
| AddedControl(Control, Int32) |
Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddHistoryPoint(NameValueCollection, String) |
Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a coleta de dados de estado e o título de estado especificados. |
| AddHistoryPoint(String, String, String) |
Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a chave de estado, o valor de estado e o título de estado especificados. |
| AddHistoryPoint(String, String) |
Cria um ponto de histórico e adiciona-o à pilha de histórico do navegador, usando a chave de estado e o valor de estado especificados. |
| AddParsedSubObject(Object) |
Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor armazenado em ClientID cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle do 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 do servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria um novo ControlCollection objeto 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 invocado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (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 de ser liberado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controle do servidor contém controles filho. Se isso não acontecer, 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, Int32) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado |
| FindControl(String) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada como um controle. (Herdado de Control) |
| GetCurrent(Page) |
Obtém a ScriptManager instância de um determinado Page objeto. |
| GetDesignModeState() |
Obtém 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 de matriz ECMAScript (JavaScript) que foram registradas anteriormente com o Page objeto. |
| GetRegisteredClientScriptBlocks() |
Recupera uma coleção somente leitura de blocos de script do cliente que foram registrados anteriormente com o ScriptManager controle. |
| GetRegisteredDisposeScripts() |
Recupera uma coleção somente leitura de |
| GetRegisteredExpandoAttributes() |
Recupera uma coleção somente leitura de atributos personalizados (expando) que foram registrados anteriormente com o Page objeto. |
| GetRegisteredHiddenFields() |
Recupera uma coleção somente leitura de campos ocultos que foram registrados anteriormente com o Page objeto. |
| GetRegisteredOnSubmitStatements() |
Recupera uma coleção somente leitura de |
| GetRegisteredStartupScripts() |
Recupera uma coleção somente leitura de scripts de inicialização que foram registrados anteriormente com o Page objeto. |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém 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 UniqueID propriedade do controle especificado. (Herdado de Control) |
| HasControls() |
Determina se o controle do servidor contém controles filho. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle do servidor contém apenas 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 SaveControlState() método. (Herdado de Control) |
| LoadPostData(String, NameValueCollection) |
Lê os dados do formulário que são postados do navegador para o 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 que foi salva pelo SaveViewState() método. (Herdado de Control) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Aciona o evento AsyncPostBackError. |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Aciona o Init evento e garante que apenas um ScriptManager controle exista na página. |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o PreRender evento e registra arquivos de script e serviços para atualizações de página parcial. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Aciona o evento ResolveCompositeScriptReference. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
Gera o ResolveScriptReference evento para cada referência de script que é gerenciada pelo ScriptManager controle. |
| 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 todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control) |
| RaisePostBackEvent(String) |
Processa um evento de postback gerado pelo ScriptManager controle e carrega o estado do histórico da página da Web. |
| RaisePostDataChangedEvent() |
Gera eventos para o ScriptManager controle quando ele é postagem de volta para o servidor. |
| RegisterArrayDeclaration(Control, String, String) |
Registra uma declaração de matriz ECMAScript (JavaScript) com o ScriptManager controle para uso com um controle que está dentro de um UpdatePanel controle e adiciona a matriz à página. |
| RegisterArrayDeclaration(Page, String, String) |
Registra uma declaração de matriz ECMAScript (JavaScript) com o ScriptManager controle para uso com um controle que está dentro de um UpdatePanel controle 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 do cliente com o ScriptManager controle para uso com um controle que está dentro de um UpdatePanel controle e adiciona o bloco de script à página. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Registra um bloco de script do cliente com o ScriptManager controle para uso com um controle que está dentro de um UpdatePanel controle e adiciona o bloco de script à página. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Registra um arquivo de script do cliente com o ScriptManager controle para uso com um controle que está dentro de um UpdatePanel controle e adiciona uma referência de arquivo de script à página. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Registra o script do cliente com o ScriptManager controle sempre que ocorre um postback assíncrono e adiciona uma referência de arquivo de script à página. |
| RegisterClientScriptResource(Control, Type, String) |
Registra o script do cliente inserido em um assembly com o ScriptManager controle para uso com um controle que está participando da renderização de página parcial. |
| RegisterClientScriptResource(Page, Type, String) |
Registra um arquivo de script do cliente inserido em um assembly com o ScriptManager controle sempre que ocorre um postback. |
| RegisterDataItem(Control, String, Boolean) |
Envia dados personalizados para um controle durante a renderização de página parcial e indica se os dados estão no formato JSON (JavaScript Object Notation). |
| RegisterDataItem(Control, String) |
Envia dados personalizados para um controle durante a renderização de página parcial. |
| RegisterDispose(Control, String) |
Registra um |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Registra um par nome/valor com o ScriptManager controle como um atributo personalizado (expando) de um controle especificado. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Registra um controle de extensor com a instância atual ScriptManager . |
| RegisterHiddenField(Control, String, String) |
Registra um campo oculto com o ScriptManager controle de um controle que está dentro de um UpdatePanel controle. |
| RegisterHiddenField(Page, String, String) |
Registra um campo oculto com o ScriptManager controle durante cada postback assíncrono. |
| RegisterNamedClientScriptResource(Control, String) |
Registra o script do cliente pelo nome do recurso inserido em um assembly com o ScriptManager controle para uso com um controle que está participando da renderização de página parcial. |
| RegisterNamedClientScriptResource(Page, String) |
Registra o script do cliente pelo nome do recurso inserido em um assembly com o ScriptManager controle para uso com um controle que está participando da renderização de página parcial. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Registra o código ECMAScript (JavaScript) com o ScriptManager controle de um controle que é usado com um UpdatePanel controle executado quando o formulário é enviado. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Registra o código ECMAScript (JavaScript) com o ScriptManager controle de um controle que é usado com um UpdatePanel controle 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 de um UpdatePanel controle que, de outra forma, executaria postbacks assíncronos. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Registra um controle de script com a instância atual ScriptManager . |
| RegisterScriptDescriptors(IExtenderControl) |
Chama de volta para uma ExtenderControl classe para retornar scripts de instância que devem ser renderizados para dar suporte ao objeto cliente que representa um controle, componente ou comportamento do cliente. |
| RegisterScriptDescriptors(IScriptControl) |
Chama uma ScriptControl classe para retornar scripts de instância que devem ser renderizados para dar suporte ao objeto cliente que representa um controle, componente ou comportamento do 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 ScriptManager controle 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 ScriptManager controle e adiciona o bloco de script à página. |
| RemovedControl(Control) |
Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o ScriptManager conteúdo do controle para o navegador usando o objeto especificado HtmlTextWriter . |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (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 é utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Salva as alterações de estado de exibição de controle do servidor que ocorreram desde o momento em que a página foi postada novamente no servidor. (Herdado de Control) |
| SetDesignModeState(IDictionary) |
Define dados de tempo de design para um controle. (Herdado de Control) |
| SetFocus(Control) |
Define o foco do navegador como o controle especificado. |
| SetFocus(String) |
Define o foco do navegador para o controle especificado pela ID. |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Causa o acompanhamento de alterações de estado de exibição no controle do servidor para que possam ser armazenadas no objeto do controle do StateBag servidor. Esse objeto é acessível por meio da ViewState propriedade. (Herdado de Control) |
Eventos
| Nome | Description |
|---|---|
| AsyncPostBackError |
Ocorre quando há um erro de página durante um postback assíncrono. |
| DataBinding |
Ocorre quando o controle do 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 do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control) |
| Navigate |
Ocorre quando o usuário clica no botão Voltar ou Avançar do navegador. |
| PreRender |
Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control) |
| ResolveCompositeScriptReference |
Ocorre quando um script composto é registrado com o ScriptManager controle. |
| ResolveScriptReference |
Ocorre quando um membro da Scripts coleção é registrado com o ScriptManager controle. |
| Unload |
Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
Métodos de Extensão
| Nome | Description |
|---|---|
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados para o controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatável para o controle de dados que contém. |
