UnauthorizedWebPart 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.
Usado para criar um objeto de espaço reservado sempre que o WebPartManager método do IsAuthorized controle retorna false para um WebPart controle. Essa classe não pode ser herdada.
public ref class UnauthorizedWebPart sealed : System::Web::UI::WebControls::WebParts::ProxyWebPart
public sealed class UnauthorizedWebPart : System.Web.UI.WebControls.WebParts.ProxyWebPart
type UnauthorizedWebPart = class
inherit ProxyWebPart
Public NotInheritable Class UnauthorizedWebPart
Inherits ProxyWebPart
- Herança
Exemplos
O exemplo de código a seguir demonstra o uso do UnauthorizedWebPart controle.
A primeira parte do exemplo de código é um controle personalizado WebPartManager que substitui o IsAuthorized(WebPart) método para criar critérios de autorização personalizados. Qualquer WebPart controle que tenha sua AuthorizationFilter propriedade definida como um valor específico ou qualquer controle que não tenha nenhum valor atribuído à propriedade será autorizado e os controles que não atenderem a esses critérios não serão autorizados.
using System;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
namespace Samples.AspNet.CS.Controls
{
public class MyManagerAuthorize : WebPartManager
{
public override bool IsAuthorized(Type type, string path, string authorizationFilter, bool isShared)
{
if (!String.IsNullOrEmpty(authorizationFilter))
{
if (authorizationFilter == "admin")
return true;
else
return false;
}
else
{
return true;
}
}
}
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyManagerAuthorize
Inherits WebPartManager
Public Overrides Function IsAuthorized(ByVal type As Type, _
ByVal path As String, ByVal authorizationFilter As String, _
ByVal isShared As Boolean) As Boolean
If Not String.IsNullOrEmpty(authorizationFilter) Then
If authorizationFilter = "admin" Then
Return True
Else
Return False
End If
Else
Return True
End If
End Function
End Class
End Namespace
A segunda parte do exemplo de código é a página da Web que hospeda o controle personalizado WebPartManager . Há três controles de servidor estáticos declarados dentro do <asp:webpartzone> elemento. Embora esses controles não sejam realmente WebPart controles, eles serão encapsulados com um GenericWebPart objeto em tempo de execução, para que você possa tratá-los como WebPart controles e, portanto, atribuir valores às suas AuthorizationFilter propriedades. Observe que o BulletedList controle tem seu filtro definido como o valor que deve permitir que ele seja autorizado, de acordo com os critérios no controle personalizado WebPartManager . O Label controle tem um valor de filtro que deve fazer com que ele não seja autorizado. O Calendar controle não atribui um valor à propriedade, portanto, por padrão, ele deve ser autorizado.
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!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 Page_Load(object sender, EventArgs e)
{
foreach (WebPart part in mgr1.WebParts)
{
if (mgr1.IsAuthorized(part))
part.ExportMode = WebPartExportMode.All;
}
}
protected void Button1_Click(object sender, EventArgs e)
{
Label2.Text = String.Empty;
foreach (WebPart part in mgr1.WebParts)
Label2.Text += part.ID + "<br />";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:MyManagerAuthorize ID="mgr1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
AuthorizationFilter="user" />
<asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="List WebPart Controls" OnClick="Button1_Click" />
<br />
<asp:Label ID="Label2" runat="server"
Text="" />
</div>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ Register Namespace="Samples.AspNet.VB.Controls"
TagPrefix="aspSample"%>
<!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 Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
Dim part As WebPart
For Each part In mgr1.WebParts
If mgr1.IsAuthorized(part) Then
part.ExportMode = WebPartExportMode.All
End If
Next
End Sub
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
Label2.Text = String.Empty
Dim part As WebPart
For Each part In mgr1.WebParts
Label2.Text += part.ID & "<br />"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:MyManagerAuthorize ID="mgr1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
AuthorizationFilter="user" />
<asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="List WebPart Controls" OnClick="Button1_Click" />
<br />
<asp:Label ID="Label2" runat="server"
Text="" />
</div>
</form>
</body>
</html>
A terceira parte do exemplo de código é uma configuração que você deve adicionar no arquivo Web.config para habilitar a exportação de arquivos de descrição de Web Parts. Verifique se você tem um arquivo Web.config no mesmo diretório que a página da Web para este exemplo de código.
<system.web> Na seção, verifique se há um <webParts> elemento com um enableExport atributo definido como true, como na marcação a seguir.
<webParts enableExport="true">
...
</webParts>
Carregue a página em um navegador e observe que os controles e os BulletedList controles Calendar são renderizados conforme o esperado, mas o Label controle não é renderizado porque não foi autorizado. Clicar no botão Listar Controles webpart faz com que o WebPartManager controle liste as IDs de todos os controles em sua WebParts coleção. Observe que a ID do Label controle está listada, provando que um UnauthorizedWebPart controle foi adicionado à árvore de controle de página para manter seu lugar, mesmo que o rótulo não seja renderizado na página.
Comentários
O conjunto de controle de Web Parts fornece um mecanismo de autorização para determinar se controles individuais WebPart podem ser adicionados a uma página. Os desenvolvedores podem, opcionalmente, atribuir uma cadeia de caracteres arbitrária à AuthorizationFilter propriedade em um WebPart controle. Quando o WebPartManager controle está adicionando controles a uma página, ele verifica esse valor de filtro em relação aos critérios definidos pelo desenvolvedor, usando o IsAuthorized método e retorna false se um controle não está autorizado.
Observação
Esse mecanismo também funciona com controles de servidor e controles de usuário que são colocados em WebPartZoneBase zonas, pois esses controles são encapsulados com um GenericWebPart objeto em tempo de execução e esse objeto herda a AuthorizationFilter propriedade.
Quando um WebPart controle não está autorizado, o WebPartManager controle insere um UnauthorizedWebPart controle na árvore de controle da página no lugar do controle não autorizado. Um UnauthorizedWebPart controle na árvore de controle reserva a posição do controle não autorizado na página e impede que quaisquer dados de personalização que um usuário possa ter aplicado anteriormente ao WebPart controle sejam perdidos.
O UnauthorizedWebPart controle nunca é exibido em uma página na qual é inserido, nem aparece no código-fonte da página renderizada. Os desenvolvedores podem verificar sua presença na árvore de controle de página verificando a WebParts propriedade do WebPartManager controle.
Construtores
| Nome | Description |
|---|---|
| UnauthorizedWebPart(String, String, String, String) |
Inicializa uma nova instância de um UnauthorizedWebPart controle, chamada quando um controle dinâmico WebPart (ou controle de servidor ou usuário) falha na autorização. |
| UnauthorizedWebPart(WebPart) |
Inicializa uma nova instância de um UnauthorizedWebPart controle, chamada quando um controle estático WebPart (ou controle de servidor ou usuário) falha na autorização. |
Propriedades
| Nome | Description |
|---|---|
| AccessKey |
Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl) |
| Adapter |
Obtém o adaptador específico do navegador para o controle. (Herdado de Control) |
| AllowClose |
Obtém ou define um valor que indica se um usuário final pode fechar um WebPart controle em uma página da Web. (Herdado de WebPart) |
| AllowConnect |
Obtém ou define um valor que indica se o WebPart controle permite que outros controles formem conexões com ele. (Herdado de WebPart) |
| AllowEdit |
Obtém ou define um valor que indica se um usuário final pode modificar um WebPart controle por meio da interface do usuário (interface do usuário) fornecida por um ou mais EditorPart controles. (Herdado de WebPart) |
| AllowHide |
Obtém ou define um valor que indica se os usuários finais têm permissão para ocultar um WebPart controle. (Herdado de WebPart) |
| AllowMinimize |
Obtém ou define um valor que indica se os usuários finais podem minimizar um WebPart controle. (Herdado de WebPart) |
| AllowZoneChange |
Obtém ou define um valor que indica se um usuário pode mover um WebPart controle entre WebPartZoneBase zonas. (Herdado de WebPart) |
| 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) |
| Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl) |
| AuthorizationFilter |
Obtém ou define uma cadeia de caracteres arbitrária para determinar se um WebPart controle está autorizado a ser adicionado a uma página. (Herdado de WebPart) |
| BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl) |
| BackImageUrl |
Obtém ou define a URL da imagem de plano de fundo para o controle do painel. (Herdado de Panel) |
| BindingContainer |
Obtém o controle que contém a associação de dados desse controle. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controle Web. (Herdado de WebControl) |
| BorderStyle |
Obtém ou define o estilo de borda do controle do servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl) |
| CatalogIconImageUrl |
Obtém ou define a URL para uma imagem que representa um controle de Web Parts em um catálogo de controles. (Herdado de WebPart) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control) |
| ChromeState |
Obtém ou define se um controle de parte está em um estado minimizado ou normal. (Herdado de WebPart) |
| ChromeType |
Obtém ou define o tipo de borda que enquadra um controle de Web Parts. (Herdado de WebPart) |
| 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) |
| ConnectErrorMessage |
Obtém uma mensagem de erro a ser exibida aos usuários se ocorrerem erros durante o processo de conexão. (Herdado de WebPart) |
| 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 contém os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de Part) |
| ControlStyle |
Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ControlStyleCreated |
Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| CssClass |
Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl) |
| 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) |
| DefaultButton |
Obtém ou define o identificador do botão padrão contido no Panel controle. (Herdado de Panel) |
| Description |
Obtém ou define uma breve frase que resume o que o controle de parte faz, para uso em Dicas de Ferramentas e catálogos de controles de parte. (Herdado de WebPart) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| Direction |
Obtém ou define a direção horizontal que o conteúdo flui dentro do controle. (Herdado de WebPart) |
| DisplayTitle |
Obtém uma cadeia de caracteres que contém o texto de título completo exibido na barra de título de uma WebPart instância de controle. (Herdado de WebPart) |
| Enabled |
Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl) |
| EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl) |
| 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) |
| ExportMode |
Obtém ou define se todas, algumas ou nenhuma das propriedades de um WebPart controle podem ser exportadas. (Herdado de WebPart) |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl) |
| ForeColor |
Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl) |
| GenericWebPartID |
Obtém o valor da ID propriedade do controle de Web Parts genérico substituído por um controle de Web Parts proxy. (Herdado de ProxyWebPart) |
| GroupingText |
Obtém ou define a legenda do grupo de controles contido no controle do painel. (Herdado de Panel) |
| HasAttributes |
Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl) |
| 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) |
| HasSharedData |
Obtém um valor que indica se um WebPart controle tem dados de personalização compartilhados associados a ele. (Herdado de WebPart) |
| HasUserData |
Obtém um valor que indica se um WebPart controle tem dados de personalização de usuário associados a ele. (Herdado de WebPart) |
| Height |
Obtém ou define a altura de uma zona. (Herdado de WebPart) |
| HelpMode |
Obtém ou define o tipo de interface do usuário usada para exibir o conteúdo da Ajuda para um WebPart controle. (Herdado de WebPart) |
| HelpUrl |
Obtém ou define a URL como um arquivo de Ajuda para um WebPart controle. (Herdado de WebPart) |
| Hidden |
Obtém ou define um valor que indica se um WebPart controle é exibido em uma página da Web. (Herdado de WebPart) |
| HorizontalAlign |
Obtém ou define o alinhamento horizontal do conteúdo dentro do painel. (Herdado de Panel) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de Web Parts. (Herdado de ProxyWebPart) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| ImportErrorMessage |
Obtém ou define uma mensagem de erro usada se ocorrerem erros quando um WebPart controle é importado. (Herdado de WebPart) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control) |
| IsClosed |
Obtém um valor que indica se um WebPart controle está fechado atualmente em uma página de Web Parts. (Herdado de WebPart) |
| IsEnabled |
Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl) |
| IsShared |
Obtém um valor que indica se um WebPart controle é compartilhado, o que significa que ele é visível para todos os usuários de uma página de Web Parts. (Herdado de WebPart) |
| IsStandalone |
Obtém um valor que indica se um WebPart controle é autônomo, o que significa que ele não está contido em uma WebPartZoneBase zona. (Herdado de WebPart) |
| IsStatic |
Obtém um valor que indica se um WebPart controle é um controle estático, o que significa que o controle é declarado na marcação de uma página de Web Parts e não adicionado à página programaticamente. (Herdado de WebPart) |
| 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) |
| 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) |
| OriginalID |
Obtém o ID controle de Web Parts substituído pelo controle de Web Parts proxy. (Herdado de ProxyWebPart) |
| OriginalPath |
Obtém o caminho para o controle de usuário que está sendo substituído. (Herdado de ProxyWebPart) |
| OriginalTypeName |
Obtém o Type controle de Web Parts substituído pelo controle de Web Parts proxy. (Herdado de ProxyWebPart) |
| 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) |
| RenderingCompatibility |
Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| ScrollBars |
Obtém ou define a visibilidade e a posição das barras de rolagem em um Panel controle. (Herdado de Panel) |
| 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 WebControl) |
| Style |
Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web. (Herdado de WebControl) |
| Subtitle |
Obtém uma cadeia de caracteres concatenada com o valor da Title propriedade para formar um título completo para um WebPart controle. (Herdado de WebPart) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o |
| TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o HtmlTextWriterTag valor que corresponde a esse controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| TagName |
Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| 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) |
| Title |
Obtém ou define o título de um controle de parte. (Herdado de WebPart) |
| TitleIconImageUrl |
Obtém ou define a URL para uma imagem usada para representar um controle de Web Parts na barra de título do controle. (Herdado de WebPart) |
| TitleUrl |
Obtém ou define uma URL para obter informações complementares sobre um WebPart controle. (Herdado de WebPart) |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl) |
| 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) |
| Verbs |
Obtém uma coleção de verbos personalizados associados a um WebPart controle. (Herdado de WebPart) |
| 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 |
Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control) |
| WebBrowsableObject |
Obtém uma referência ao WebPart controle para permitir que ele seja editado por controles personalizados EditorPart . (Herdado de WebPart) |
| WebPartManager |
Obtém uma referência ao WebPartManager controle associado a uma WebPart instância de controle. (Herdado de WebPart) |
| Width |
Obtém ou define a largura do controle do servidor Web. (Herdado de WebPart) |
| Wrap |
Obtém ou define um valor que indica se o conteúdo encapsula dentro do painel. (Herdado de Panel) |
| Zone |
Obtém a WebPartZoneBase zona que atualmente contém um WebPart controle. (Herdado de WebPart) |
| ZoneIndex |
Obtém a posição de índice de um WebPart controle dentro de sua zona. (Herdado de WebPart) |
Métodos
| Nome | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona informações sobre a imagem de plano de fundo, alinhamento, encapsulamento e direção à lista de atributos a serem renderizados. (Herdado de Panel) |
| AddedControl(Control, Int32) |
Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| 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) |
| ApplyStyle(Style) |
Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| 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) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| 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) |
| CreateControlStyle() |
Cria um objeto de estilo que é usado internamente pelo Panel controle para implementar todas as propriedades relacionadas ao estilo. (Herdado de Panel) |
| CreateEditorParts() |
Retorna uma coleção de controles personalizados EditorPart que podem ser usados para editar um WebPart controle quando ele estiver no modo de edição. (Herdado de WebPart) |
| DataBind() |
Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho. (Herdado de Part) |
| 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) |
| 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) |
| 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) |
| 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) |
Substitui para LoadControlState(Object) impedir o carregamento do estado salvo anteriormente para um ProxyWebPart objeto. (Herdado de ProxyWebPart) |
| LoadViewState(Object) |
Substitui para LoadViewState(Object) impedir o carregamento do estado de exibição salvo anteriormente para um ProxyWebPart objeto. (Herdado de ProxyWebPart) |
| 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) |
| MergeStyle(Style) |
Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| 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) |
| OnClosing(EventArgs) |
Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle é fechado em uma página de Web Parts. (Herdado de WebPart) |
| OnConnectModeChanged(EventArgs) |
Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle está iniciando ou encerrando o processo de conexão com outros controles. (Herdado de WebPart) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnDeleting(EventArgs) |
Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle é permanentemente removido de uma página de Web Parts. (Herdado de WebPart) |
| OnEditModeChanged(EventArgs) |
Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle está entrando ou saindo do modo de edição. (Herdado de WebPart) |
| OnInit(EventArgs) |
Aciona o evento Init. (Herdado de Control) |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de Control) |
| 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) |
| RemovedControl(Control) |
Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o controle para o gravador HTML especificado. (Herdado de WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a marca de abertura HTML do Panel controle para o gravador especificado. (Herdado de Panel) |
| 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) |
| RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| 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) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do Panel controle no gravador especificado. (Herdado de Panel) |
| 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 ProxyWebPart) |
| SaveViewState() |
Salva qualquer estado modificado após a invocação do TrackViewState() método. (Herdado de ProxyWebPart) |
| SetDesignModeState(IDictionary) |
Define dados de tempo de design para um controle. (Herdado de Control) |
| SetPersonalizationDirty() |
Define um sinalizador que indica que os dados de personalização foram alterados para a instância de controle atual WebPart . (Herdado de WebPart) |
| 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() |
Faz com que o controle rastreie as alterações no estado de exibição para que elas possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebPart) |
Eventos
| Nome | Description |
|---|---|
| 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) |
| PreRender |
Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permite que o desenvolvedor de um designer para um controle de parte composta recrie os controles filho do controle na superfície de design. (Herdado de Part) |
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição deste membro, consulte UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| Nome | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| 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. |
| GetDefaultValues(INamingContainer) |
Obtém a coleção dos valores padrão para o controle de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controle de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |