WebPartManagerInternals Classe

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Isola em métodos de classe separados que são usados pelo controle WebPartManager e podem ser substituídos por desenvolvedores que estendem o controle, mas raramente são necessários para os desenvolvedores de página.

public ref class WebPartManagerInternals sealed

public sealed class WebPartManagerInternals

type WebPartManagerInternals = class

Public NotInheritable Class WebPartManagerInternals

Herança

Object

WebPartManagerInternals

Comentários

A WebPartManager classe é a maior classe no conjunto de controle de Web Parts. Ele também está entre as classes de Web Parts mais importantes porque é usado em todas as páginas da Web que contêm controles de Web Parts e coordena e gerencia todos os controles de Web Parts em uma página.

Como a WebPartManager classe é usada com tanta frequência e por conter tantos métodos expostos, alguns métodos necessários principalmente para os desenvolvedores de controle que estão estendendo o WebPartManager controle estão contidos na WebPartManagerInternals classe . Esse isolamento de métodos menos usados na WebPartManagerInternals classe simplifica a API da WebPartManager classe e os métodos isolados não aparecem no WebPartManager objeto no IntelliSense.

Os desenvolvedores que usam a WebPartManagerInternals classe provavelmente terão cenários em que precisam herdar do WebPartManager controle e personalizá-lo extensivamente. Por exemplo, se você estiver criando um aplicativo do portal da Web ou um conjunto empacotado de controles de Web Parts com modos de exibição personalizados, zonas personalizadas, verbos personalizados, controles personalizados WebPart e outras extensões da interface do usuário de Web Parts base, em muitos casos (nem todos) você precisará substituir e estender alguns dos WebPartManager membros. E embora a WebPartManagerInternals classe seja lacrada para que você não possa herdar dela, sua classe personalizada WebPartManager provavelmente precisará chamar vários dos métodos para gerenciar controles WebPartManagerInternals de Web Parts em uma página.

Observação

Assim como a WebPartManager classe , a WebPartManagerInternals classe fornece um controle de servidor que não tem interface do usuário e nunca fica visível em uma página. Ao contrário WebPartManagerde , a WebPartManagerInternals classe nunca é declarada na marcação de uma página; é estritamente um objeto de trabalho que executa tarefas em segundo plano. A maneira típica de usá-la é demonstrada pela classe , que faz referência a WebPartManager ela por meio da propriedade protegida Internals e usa o objeto referenciado para chamar os WebPartManagerInternals métodos.

A WebPartManagerInternals classe contém apenas métodos; não há propriedades ou eventos. Todos os métodos na classe envolvem o gerenciamento de WebPart controles ou conexões entre controles.

Para manipular WebPart controles, WebPartManagerInternals inclui métodos para adicioná-los (AddWebPart), removê-los RemoveWebPart), manipular eventos CallOnDeleting), obter ou definir detalhes sobre sua relação com sua zona (por exemplo, GetZoneID e SetZoneIndex) ou definir propriedades de controle básicas WebPart (por exemplo, SetIsClosed e SetHasSharedData).

Para lidar com conexões, WebPartManagerInternals inclui métodos para excluí-las (DeleteConnection), definir qual objeto transformador usar (SetTransformer), definir se uma conexão é compartilhada e se ela é estática (SetIsShared(WebPartConnection, Boolean) e SetIsStatic(WebPartConnection, Boolean)) e definir uma mensagem de erro de conexão a ser usada (SetConnectErrorMessage).

Métodos

AddWebPart(WebPart)	Adiciona um WebPart ou um controle de servidor à coleção de controles WebPart do controle WebPartManager em uma página da Web.
CallOnClosing(WebPart)	Chama o método OnClosing(EventArgs) do controle especificado.
CallOnConnectModeChanged(WebPart)	Chama o método OnConnectModeChanged(EventArgs) do controle especificado.
CallOnDeleting(WebPart)	Chama o método OnDeleting(EventArgs) do controle especificado.
CallOnEditModeChanged(WebPart)	Chama o método OnEditModeChanged(EventArgs) do controle especificado.
ConnectionDeleted(WebPartConnection)	Indica se o objeto WebPartConnection especificado foi excluído.
CreateObjectFromType(Type)	Cria um objeto com base no parâmetro passado para o método.
DeleteConnection(WebPartConnection)	Define uma propriedade para indicar que o objeto de conexão especificado foi excluído.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetZoneID(WebPart)	Obtém a ID de uma zona que contém o controle de servidor ou WebPart especificado.
LoadConfigurationState(WebPartTransformer, Object)	Carrega dados de estado salvos anteriormente para um objeto WebPartTransformer que participa de uma conexão entre controles.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
RemoveWebPart(WebPart)	Remove um WebPart ou outro controle de servidor da coleção de controle do controle WebPartManager.
SaveConfigurationState(WebPartTransformer)	Salva os dados de estado para um objeto WebPartTransformer que participa em uma conexão entre controles.
SetConnectErrorMessage(WebPart, String)	Estabelece uma mensagem de erros e faz com que o objeto WebPartChrome que é responsável por renderizar um controle WebPart renderize essa mensagem em vez do conteúdo do controle.
SetHasSharedData(WebPart, Boolean)	Define uma propriedade em um WebPart ou outro controle de servidor que indica se o controle tem dados de personalização compartilhados.
SetHasUserData(WebPart, Boolean)	Define uma propriedade em um WebPart ou outro controle de servidor que indica se o controle tem dados de personalização de usuário.
SetIsClosed(WebPart, Boolean)	Define a propriedade IsClosed de um controle WebPart.
SetIsShared(WebPart, Boolean)	Define a propriedade IsShared de um controle WebPart.
SetIsShared(WebPartConnection, Boolean)	Define a propriedade IsShared de um objeto WebPartConnection.
SetIsStandalone(WebPart, Boolean)	Define a propriedade IsStandalone de um controle WebPart.
SetIsStatic(WebPart, Boolean)	Define a propriedade IsStatic de um controle WebPart.
SetIsStatic(WebPartConnection, Boolean)	Define a propriedade IsStatic de um objeto WebPartConnection.
SetTransformer(WebPartConnection, WebPartTransformer)	Atribui um objeto WebPartTransformer a ser usado em uma conexão entre dois controles de servidor.
SetZoneID(WebPart, String)	Define uma propriedade que habilita um WebPart ou controle de servidor para manter a ID da zona de contenção.
SetZoneIndex(WebPart, Int32)	Define o índice do controle especificado dentro da zona em relação a outros controles WebPart dentro da zona.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• WebPartManager
• Controles de Web Parts do ASP.NET