WebPartManagerInternals Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Isola em métodos de classe separados que são usados pelo WebPartManager controlo e podem ser sobrepostos por programadores que estendem o controlo, mas raramente são necessários pelos programadores de páginas.
public ref class WebPartManagerInternals sealedpublic sealed class WebPartManagerInternalstype WebPartManagerInternals = classPublic NotInheritable Class WebPartManagerInternals- Herança
-
WebPartManagerInternals
Observações
A WebPartManager classe é a maior do conjunto de controlo Web Parts. É também uma das classes de Web Parts mais importantes porque é utilizada em todas as páginas Web que contenham controlos de Web Parts, e coordena e gere todos os controlos de Web Parts numa página.
Como a WebPartManager classe é usada com tanta frequência, e porque contém tantos métodos expostos, alguns métodos necessários principalmente por desenvolvedores de controlo que estendem o WebPartManager controlo estão incluídos na WebPartManagerInternals classe. Este isolamento dos métodos menos utilizados na WebPartManagerInternals classe simplifica a API da WebPartManager classe, e os métodos isolados não aparecem no WebPartManager objeto no IntelliSense.
Os programadores que usam a WebPartManagerInternals classe provavelmente terão cenários em que precisam de herdar o WebPartManager controlo e personalizá-lo extensivamente. Por exemplo, se estiver a construir uma aplicação de portal Web ou um conjunto de controlos Web Parts com modos de visualização personalizados, zonas personalizadas, verbos personalizados, controlos personalizados WebPart e outras extensões da interface de utilizador (UI) base das Web Parts, em muitos casos (não todos) terá de sobrescrever e estender alguns dos WebPartManager membros. E embora a WebPartManagerInternals classe esteja selada para que não possa herdar dela, a sua classe personalizada WebPartManager provavelmente terá de chamar vários métodos WebPartManagerInternals para gerir os controlos de Web Parts numa página.
Note
Tal como a WebPartManager classe, a WebPartManagerInternals classe fornece um controlo de servidor que não tem interface e nunca é visível numa página. Ao contrário de WebPartManager, a WebPartManagerInternals classe nunca é declarada na marcação de uma página; é estritamente um objeto worker que executa tarefas em segundo plano. A forma típica de o usar é demonstrada pela WebPartManager classe, que o referencia através 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 existem propriedades nem eventos. Todos os métodos da aula envolvem gerir WebPart controlos, ou ligações entre controlos.
Para lidar WebPart com controlos, WebPartManagerInternals inclui métodos para os adicionar (AddWebPart), removê-los RemoveWebPart), gerir eventos CallOnDeleting), obter ou definir detalhes sobre a sua relação com a sua zona (por exemplo, GetZoneID e SetZoneIndex), ou definir propriedades básicas WebPart de controlo (por exemplo, SetIsClosed e SetHasSharedData).
Para tratar ligações, WebPartManagerInternals inclui métodos para as eliminar (DeleteConnection), definir qual o objeto transformador a usar (SetTransformer), definir se uma ligação é partilhada e se é estática (SetIsShared(WebPartConnection, Boolean) e SetIsStatic(WebPartConnection, Boolean)), e definir uma mensagem de erro de ligação para usar (SetConnectErrorMessage).
Métodos
| Name | Description |
|---|---|
| AddWebPart(WebPart) |
Adiciona um WebPart ou um controlo de servidor à WebPartManager coleção de WebPart controlos do controlo numa página Web. |
| CallOnClosing(WebPart) |
Chama o OnClosing(EventArgs) método do controlo especificado. |
| CallOnConnectModeChanged(WebPart) |
Chama o OnConnectModeChanged(EventArgs) método do controlo especificado. |
| CallOnDeleting(WebPart) |
Chama o OnDeleting(EventArgs) método do controlo especificado. |
| CallOnEditModeChanged(WebPart) |
Chama o OnEditModeChanged(EventArgs) método do controlo especificado. |
| ConnectionDeleted(WebPartConnection) |
Indica se o objeto especificado WebPartConnection foi eliminado. |
| CreateObjectFromType(Type) |
Cria um objeto com base no parâmetro passado ao método. |
| DeleteConnection(WebPartConnection) |
Define uma propriedade para indicar que o objeto de ligação especificado foi eliminado. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetZoneID(WebPart) |
Obtém o ID de uma zona que contém o controlo especificado WebPart ou do servidor. |
| LoadConfigurationState(WebPartTransformer, Object) |
Carrega dados de estado previamente guardados para um WebPartTransformer objeto que participa numa ligação entre controlos. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| RemoveWebPart(WebPart) |
Remove um WebPart ou outro controlo de servidor da WebPartManager coleção de controlos do controlo. |
| SaveConfigurationState(WebPartTransformer) |
Guarda os dados de estado de um WebPartTransformer objeto que participa numa ligação entre controlos. |
| SetConnectErrorMessage(WebPart, String) |
Estabelece uma mensagem de erro e faz com que o WebPartChrome objeto responsável por renderizar um WebPart controlo apresente essa mensagem em vez do conteúdo do controlo. |
| SetHasSharedData(WebPart, Boolean) |
Define uma propriedade num WebPart ou outro controlo de servidor indicando se o controlo tem dados de personalização partilhados. |
| SetHasUserData(WebPart, Boolean) |
Define uma propriedade num WebPart ou outro controlo de servidor indicando se o controlo tem dados de personalização do utilizador. |
| SetIsClosed(WebPart, Boolean) | |
| SetIsShared(WebPart, Boolean) | |
| SetIsShared(WebPartConnection, Boolean) |
Define a IsShared propriedade de um WebPartConnection objeto. |
| SetIsStandalone(WebPart, Boolean) |
Define a IsStandalone propriedade de um WebPart controlo. |
| SetIsStatic(WebPart, Boolean) | |
| SetIsStatic(WebPartConnection, Boolean) |
Define a IsStatic propriedade de um WebPartConnection objeto. |
| SetTransformer(WebPartConnection, WebPartTransformer) |
Atribui um WebPartTransformer objeto a ser usado numa ligação entre dois controlos de servidor. |
| SetZoneID(WebPart, String) |
Define uma propriedade que permite que um WebPart ou o controlo do servidor mantenha o ID da zona contendora. |
| SetZoneIndex(WebPart, Int32) |
Define o índice do controlo especificado dentro da sua zona em relação aos outros WebPart controlos dentro da zona. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |