WebPartManagerInternals 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.
Isola em métodos de classe separados que são usados pelo WebPartManager controle e podem ser substituídos por desenvolvedores que estendem o controle, mas raramente são necessários para desenvolvedores de páginas.
public ref class WebPartManagerInternals sealed
public sealed class WebPartManagerInternals
type WebPartManagerInternals = class
Public NotInheritable Class WebPartManagerInternals
- Herança
-
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á-la 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 base de Web Parts, em muitos casos (nem todos) você precisará substituir e estender alguns dos WebPartManager membros. E embora a WebPartManagerInternals classe esteja selada 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 é visível em uma página. Diferentemente WebPartManager, a WebPartManagerInternals classe nunca é declarada na marcação de uma página; ela é 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 lidar com WebPart controles, WebPartManagerInternals inclui métodos para adicioná-los (AddWebPart), removê-los RemoveWebPart), lidar com eventos CallOnDeleting), obter ou definir detalhes sobre sua relação com sua zona (por exemplo, GetZoneID e SetZoneIndex), ou definir propriedades básicas WebPart de controle (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
| Nome | Description |
|---|---|
| AddWebPart(WebPart) |
Adiciona um WebPart controle ou servidor à WebPartManager coleção de WebPart controles do controle em uma página da Web. |
| CallOnClosing(WebPart) |
Chama o OnClosing(EventArgs) método do controle especificado. |
| CallOnConnectModeChanged(WebPart) |
Chama o OnConnectModeChanged(EventArgs) método do controle especificado. |
| CallOnDeleting(WebPart) |
Chama o OnDeleting(EventArgs) método do controle especificado. |
| CallOnEditModeChanged(WebPart) |
Chama o OnEditModeChanged(EventArgs) método do controle especificado. |
| ConnectionDeleted(WebPartConnection) |
Indica se o objeto especificado WebPartConnection 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 a Type instância atual. (Herdado de Object) |
| GetZoneID(WebPart) |
Obtém a ID de uma zona que contém o controle de servidor ou especificado WebPart . |
| LoadConfigurationState(WebPartTransformer, Object) |
Carrega dados de estado salvos anteriormente para um WebPartTransformer objeto que participa de uma conexão entre controles. |
| MemberwiseClone() |
Cria uma cópia superficial da atual Object. (Herdado de Object) |
| RemoveWebPart(WebPart) |
Remove um WebPart ou outro controle de servidor da WebPartManager coleção de controles do controle. |
| SaveConfigurationState(WebPartTransformer) |
Salva dados de estado para um WebPartTransformer objeto que participa de uma conexão entre controles. |
| SetConnectErrorMessage(WebPart, String) |
Estabelece uma mensagem de erros e faz com que o WebPartChrome objeto responsável por renderizar um WebPart controle renderize essa mensagem em vez do conteúdo do controle. |
| SetHasSharedData(WebPart, Boolean) |
Define uma propriedade em um WebPart ou outro controle de servidor indicando se o controle tem dados de personalização compartilhados. |
| SetHasUserData(WebPart, Boolean) |
Define uma propriedade em um WebPart ou outro controle de servidor indicando se o controle tem dados de personalização do usuário. |
| 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 controle. |
| SetIsStatic(WebPart, Boolean) | |
| SetIsStatic(WebPartConnection, Boolean) |
Define a IsStatic propriedade de um WebPartConnection objeto. |
| SetTransformer(WebPartConnection, WebPartTransformer) |
Atribui um WebPartTransformer objeto a ser usado em uma conexão entre dois controles de servidor. |
| SetZoneID(WebPart, String) |
Define uma propriedade que permite que um WebPart controle ou servidor mantenha a ID da zona de contenção. |
| SetZoneIndex(WebPart, Int32) |
Define o índice do controle especificado dentro de sua zona em relação aos outros WebPart controles dentro da zona. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |