UnauthorizedWebPart Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

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

Usado para criar um objeto de espaço reservado sempre que o método IsAuthorized do controle WebPartManager retornar false para um controle WebPart. 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: Object

Control

WebControl

Panel

Part

WebPart

ProxyWebPart
UnauthorizedWebPart

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ático 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 truecomo , como na marcação a seguir.

<webParts enableExport="true">

...

</webParts>

Carregue a página em um navegador e observe que os BulletedList controles e 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 de 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. Opcionalmente, os desenvolvedores podem 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 é 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 ele é 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

UnauthorizedWebPart(String, String, String, String)	Inicializa uma nova instância de um controle UnauthorizedWebPart, chamado quando a autorização de um controle dinâmico WebPart (ou servidor ou controle de usuário) falha.
UnauthorizedWebPart(WebPart)	Inicializa uma nova instância de um controle UnauthorizedWebPart, chamado quando a autorização de um controle estático WebPart (ou servidor ou controle de usuário) falha.

Propriedades

AccessKey	Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AllowClose	Obtém ou define um valor que indica se um usuário final pode fechar um controle WebPart em uma página da Web. (Herdado de WebPart)
AllowConnect	Obtém ou define um valor que indica se o controle WebPart 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 controle WebPart por meio da interface do usuário fornecida por um ou mais controles EditorPart. (Herdado de WebPart)
AllowHide	Obtém ou define um valor que indica se os usuários finais podem ocultar um controle WebPart. (Herdado de WebPart)
AllowMinimize	Obtém ou define um valor que indica se os usuários finais podem minimizar um controle WebPart. (Herdado de WebPart)
AllowZoneChange	Obtém ou define um valor que indica se um usuário pode mover um controle WebPart entre zonas WebPartZoneBase. (Herdado de WebPart)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl)
AuthorizationFilter	Obtém ou define uma cadeia de caracteres arbitrária para determinar se um controle WebPart tem autorização para 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 tela de fundo do controle do painel. (Herdado de Panel)
BindingContainer	Obtém o controle que contém a vinculaçã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 de servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle de 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 de servidor foram criados. (Herdado de Control)
ChromeState	Obtém ou define se um controle Part está em um estado minimizado ou normal. (Herdado de WebPart)
ChromeType	Obtém ou define o tipo de borda que emoldura um controle de Web Parts. (Herdado de WebPart)
ClientID	Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
ConnectErrorMessage	Obtém uma mensagem de erro para exibir para os usuários se ocorrerem erros durante o processo de conexão. (Herdado de WebPart)
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que contém os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Part)
ControlStyle	Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. 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 implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DefaultButton	Obtém ou define o identificador do botão padrão contido no controle Panel. (Herdado de Panel)
Description	Obtém ou define uma frase curta que resume o que o controle Part faz, para ser usada em dicas de ferramenta e catálogos de controles Part. (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 em 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 realmente exibido na barra de título de uma instância de controle WebPart. (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 de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
ExportMode	Obtém ou define se todas, algumas ou nenhuma das propriedades de um controle WebPart 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 de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl)
GenericWebPartID	Obtém o valor da propriedade ID do controle de Web Parts genérico substituído por um controle de Web Parts de proxy. (Herdado de ProxyWebPart)
GroupingText	Obtém ou define a legenda para o grupo de controles contidos 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 de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
HasSharedData	Obtém um valor que indica se um controle WebPart tem dados de personalização compartilhados associados a ele. (Herdado de WebPart)
HasUserData	Obtém um valor que indica se um controle WebPart 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 a ser usada para exibir o conteúdo de Ajuda para um controle WebPart. (Herdado de WebPart)
HelpUrl	Obtém ou define a URL para um arquivo de Ajuda para um controle WebPart. (Herdado de WebPart)
Hidden	Obtém ou define um valor que indica se um controle WebPart é exibido em uma página da Web. (Herdado de WebPart)
HorizontalAlign	Obtém ou define o alinhamento horizontal do conteúdo no 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 que é usada se ocorrerem erros quando um controle WebPart for importado. (Herdado de WebPart)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsClosed	Obtém um valor que indica se um controle WebPart está fechado no momento 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 controle WebPart é 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 controle WebPart é autônomo, o que significa que ele não está contido em uma zona WebPartZoneBase. (Herdado de WebPart)
IsStatic	Obtém um valor que indica se um controle WebPart é 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 de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
OriginalID	Obtém o ID do controle de Web Parts substituído pelo controle de Web Parts do 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 do controle de Web Parts substituído pelo controle de Web Parts do proxy. (Herdado de ProxyWebPart)
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
ScrollBars	Obtém ou define a visibilidade e a posição das barras de rolagem em um controle Panel. (Herdado de Panel)
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a capa a ser aplicada ao controle. (Herdado de 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 de servidor Web. (Herdado de WebControl)
Subtitle	Obtém uma cadeia de caracteres que é concatenada com o valor da propriedade Title para compor um título completo para um controle WebPart. (Herdado de WebPart)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o atributo `disabled` do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é `false`. (Herdado de Panel)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o valor HtmlTextWriterTag que corresponde ao controle do 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 este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
Title	Obtém ou define o título de um controle Part. (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 informações complementares sobre um controle WebPart. (Herdado de WebPart)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
Verbs	Obtém uma coleção de verbos personalizados associados a um controle WebPart. (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 objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control)
WebBrowsableObject	Obtém uma referência para o controle WebPart para habilitá-lo para ser editado por controles EditorPart personalizados. (Herdado de WebPart)
WebPartManager	Obtém uma referência para o controle WebPartManager associado a uma instância do controle WebPart. (Herdado de WebPart)
Width	Obtém ou define a largura do controle de servidor Web. (Herdado de WebPart)
Wrap	Obtém ou define um valor que indica se o conteúdo será quebrado dentro do painel. (Herdado de Panel)
Zone	Obtém a zona WebPartZoneBase que contém um controle WebPart no momento. (Herdado de WebPart)
ZoneIndex	Obtém a posição do índice de um controle WebPart dentro da zona. (Herdado de WebPart)

Métodos

AddAttributesToRender(HtmlTextWriter)	Adiciona informações sobre a imagem de tela de fundo, o alinhamento, o encapsulamento e a direção para a lista de atributos a renderizar. (Herdado de Panel)
AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control)
ApplyStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateChildControls()	Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria um objeto de estilo que é usado internamente pelo controle Panel 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 controle WebPart quando ele está em modo de edição. (Herdado de WebPart)
DataBind()	Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Part)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de Control)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para um controle. (Herdado de Control)
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
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 propriedade UniqueID do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Substitui LoadControlState(Object) para evitar carregar o estado salvo anteriormente para um objeto ProxyWebPart. (Herdado de ProxyWebPart)
LoadViewState(Object)	Substitui LoadViewState(Object) para evitar carregar o estado de exibição salvo anteriormente para um objeto ProxyWebPart. (Herdado de ProxyWebPart)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MergeStyle(Style)	Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnClosing(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart é fechado em uma página de Web Parts. (Herdado de WebPart)
OnConnectModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart está iniciando ou concluindo 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 controle WebPart é removido permanentemente de uma página de Web Parts. (Herdado de WebPart)
OnEditModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart 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 quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o controle para o gravador de HTML especificado. (Herdado de WebControl)
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do controle Panel para o gravador especificado. (Herdado de Panel)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle Panel para o 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 possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de ProxyWebPart)
SaveViewState()	Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado. (Herdado de ProxyWebPart)
SetDesignModeState(IDictionary)	Define os 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 WebPart atual. (Herdado de WebPart)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o controle acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto. (Herdado de WebPart)

Eventos

DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite ao desenvolvedor de um designer para um controle Part de composição recriar os controles filho do controle na superfície de design. (Herdado de Part)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.
GetDefaultValues(INamingContainer)	Obtém a coleção de valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados de tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
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.

Aplica-se a

Partilhar via