WorksheetBase Classe

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.v4.0.Utilities.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.

Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.

public ref class WorksheetBase abstract : IDisposable, Microsoft::Office::Tools::Excel::IWorksheetExtension, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent

[System.ComponentModel.ToolboxItem(false)]
public abstract class WorksheetBase : IDisposable, Microsoft.Office.Tools.Excel.IWorksheetExtension, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent

[<System.ComponentModel.ToolboxItem(false)>]
type WorksheetBase = class
    interface IWorksheetExtension
    interface IExtension
    interface EntryPoint
    interface ISupportInitialize
    interface IBindableComponent
    interface IComponent
    interface IDisposable

Public MustInherit Class WorksheetBase
Implements IBindableComponent, IComponent, IDisposable, ISupportInitialize, IWorksheetExtension

Herança: Object
WorksheetBase

Atributos: ToolboxItemAttribute

Implementações: EntryPoint IWorksheetExtension IExtension IComponent ISupportInitialize IDisposable IBindableComponent

Comentários

A WorksheetBase classe é a classe base para as Sheet classes n em projetos do Excel no nível do documento criados usando o Visual Studio. Use as Sheet classes n para acessar programaticamente as planilhas em seu projeto. A WorksheetBase classe é um item de host que representa uma planilha em projetos no nível do documento. Para obter mais informações, consulte Visão geral de itens de host e controles de host e Item de host de planilha.

A WorksheetBase classe fornece os mesmos membros que a Microsoft.Office.Interop.Excel.Worksheet classe no assembly de interoperabilidade primário do Excel, mas adiciona os seguintes recursos:

Propriedade Controls. Use essa propriedade para adicionar controles gerenciados a uma planilha do Excel, ou para remover controles, em tempo de execução.
Propriedade InnerObject. Use essa propriedade para obter o objeto subjacente Microsoft.Office.Interop.Excel.Worksheet para um item de host de planilha.
Método GetAutomationObject. Substitua esse método para expor uma classe em seu projeto ao código VBA na planilha.
Eventos no nível do documento, como ActivateEvent e Change, que são fornecidos somente no nível do aplicativo no modelo de objeto do Excel. Ou seja, no modelo de objeto do Excel, esses eventos são definidos na Microsoft.Office.Interop.Excel.Application classe em vez da Microsoft.Office.Interop.Excel.Worksheet classe .

Criando itens de host da planilha

Não é possível criar WorksheetBase objetos programaticamente em projetos do Office.

Em projetos de nível de documento, as Sheetclasses n (que derivam de WorksheetBase) são instanciadas automaticamente pelo runtime do Visual Studio Tools para Office quando o usuário final abre a pasta de trabalho. Para obter mais informações, consulte Programação Document-Level personalizações.

Em projetos no nível do aplicativo, você pode criar itens de host de planilha programaticamente usando o GetVstoObject método . O item de host da planilha que você cria é um Microsoft.Office.Tools.Excel.Worksheet objeto, em vez de um WorksheetBase objeto . Para obter mais informações, consulte Estendendo documentos Word e pastas de trabalho do Excel em suplementos vsto em tempo de execução.

Uso

Esse tipo é usado apenas nos projetos do Office direcionados ao .NET Framework 4 ou posterior. O assembly que define esse tipo não é parte do Visual Studio Tools para Office Runtime. Você deve implantar esse assembly junto com sua solução. Confira mais informações em Assemblies no Visual Studio Tools para Office Runtime.

Construtores

WorksheetBase(Factory, IServiceProvider, String, String)

Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.

Propriedades

Application	Obtém um objeto Application que representa o aplicativo do Microsoft Office Excel.
AutoFilter	Obtém um AutoFilter que fornece informações sobre as listas filtradas na planilha, caso a filtragem esteja habilitada. Obterá `null`, se a filtragem estiver desativada.
AutoFilterMode	Obtém ou define um valor que indica se a filtragem está atualmente habilitada na planilha (ou seja, se as setas suspensas do filtro são atualmente exibidas).
Base	Obtém o objeto Worksheet que esse objeto WorksheetBase estende.
BindingContext	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Cells	Obtém um objeto Range que representa todas as células na planilha (não apenas as células que estão em uso no momento).
CircularReference	Obtém um objeto Range que representa o intervalo que contém a primeira referência circular da planilha ou obtém `null` caso não haja nenhuma referência circular na planilha.
Columns	Obtém um objeto Range que representa uma ou mais colunas na planilha.
Comments	Obtém uma coleção Comments que representa todos os comentários da planilha.
ConsolidationFunction	Obtém o código de função usado para a consolidação atual.
ConsolidationOptions	Obtém um Array de três elementos das opções de consolidação.
ConsolidationSources	Obtém um Array de cadeias de caracteres que nomeiam os intervalos e as planilhas de origem para a consolidação atual da planilha.
Controls	Obtém a coleção de controles gerenciados contidos na planilha.
Creator	Obtém um valor que indica o aplicativo no qual a planilha foi criada.
CustomProperties	Obtém um objeto CustomProperties que representa as informações de identificador associadas a uma planilha.
DataBindings	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
DataHost	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
DisplayPageBreaks	Obtém ou define um valor que indica se as quebras de página (automáticas e manuais) na planilha são exibidas.
DisplayRightToLeft	Obtém ou define um valor que indica se a planilha será exibida da direita para a esquerda, em vez de da esquerda para a direita.
EnableAutoFilter	Obtém ou define um valor que indica se as setas de filtro automático estão habilitadas quando a proteção somente da interface do usuário está ativada.
EnableCalculation	Obtém ou define um valor que indica se o Microsoft Office Excel recalcula automaticamente a planilha quando necessário.
EnableFormatConditionsCalculation	Obtém ou define um valor que determina se os formatos condicionais ocorrerão automaticamente.
EnableOutlining	Obtém ou define um valor que indica se os símbolos de descrição estão habilitados quando a proteção somente da interface do usuário está ativada. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. As marcas inteligentes foram preteridas no Office 2010. Esse tipo ou membro está destinado a uso apenas em projetos do sistema Microsoft Office 2007. As marcas inteligentes foram preteridas no Office 2010.
EnablePivotTable	Obtém ou define um valor que indica se os controles e ações de Tabela Dinâmica estão habilitados quando a proteção somente da interface do usuário está ativada.
EnableSelection	Obtém ou define um valor que indica quais células podem ser selecionadas na folha.
FilterMode	Obtém um valor que indica se a planilha está filtrando os dados ativamente.
HostContext	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
HPageBreaks	Obtém uma coleção HPageBreaks que representa as quebras de página horizontais na planilha.
Hyperlinks	Obtém uma coleção Hyperlinks que representa os hiperlinks para o intervalo ou para a planilha.
Index	Obtém o número de índice da planilha dentro da coleção de planilhas.
InnerObject	Obtém um Worksheet que representa o objeto nativo subjacente para o WorksheetBase.
ItemProvider	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
ListObjects	Obtém uma coleção de objetos ListObject na planilha.
MailEnvelope	Obtém um cabeçalho de email para a planilha.
Name	Obtém ou define o nome da planilha.
Names	Obtém uma Names coleção que representa todos os nomes específicos da planilha (nomes definidos com o prefixo "WorksheetName!").
Next	Obtém um Worksheet que representa a próxima planilha.
Outline	Obtém um Outline que representa a estrutura de tópicos para a planilha.
PageSetup	Obtém um PageSetup que contém todas as definições de configuração de página para a planilha.
Parent	Obtém o objeto pai da planilha.
Previous	Obtém um Worksheet que representa a planilha anterior.
PrintedCommentPages	Obtém o número de páginas de comentário que será impresso para a planilha atual. Essa propriedade só pode ser usada em projetos do Excel 2010.
ProtectContents	Obtém um valor que indica se o conteúdo da planilha (as células individuais) está protegido.
ProtectDrawingObjects	Obtém um valor que indica se as formas estão protegidas.
Protection	Obtém um objeto Protection que representa as opções de proteção da planilha.
ProtectionMode	Obtém um valor que indica se a proteção somente da interface do usuário está ativada.
ProtectScenarios	Obtém um valor que indica se os cenários de planilha estão protegidos.
QueryTables	Obtém a coleção de QueryTables, que representa todas as tabelas de consulta na planilha.
Range	Obtém um objeto Range que representa uma célula ou um intervalo de células.
Rows	Obtém um objeto Range que representa uma ou mais linhas na planilha.
ScrollArea	Obtém ou define o intervalo em que a rolagem é permitida, como uma referência de intervalo de estilo A1.
Shapes	Obtém um objeto Shapes que representa todas as formas na planilha.
Site	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Sort	Obtém os valores classificados na planilha atual.
StandardHeight	Obtém a altura padrão de todas as linhas na planilha, em pontos.
StandardWidth	Obtém ou define a largura padrão de todas as colunas na planilha.
Tab	Obtém um Tab para a planilha.
Tag	Obtém ou define o objeto que contém dados sobre a planilha.
TransitionExpEval	Obtém ou define um valor que indica se o Microsoft Office Excel usa as regras de avaliação de expressões do Lotus 1-2-3 para a planilha.
TransitionFormEntry	Obtém ou define um valor que indica se o Microsoft Office Excel usa as regras de entrada de fórmula do Lotus 1-2-3 para a planilha.
Type	Obtém o tipo da planilha.
UsedRange	Obtém um objeto Range que representa todas as células que contêm um valor a qualquer momento.
Visible	Obtém ou define um valor de XlSheetVisibility que determina se o objeto é visível.
VPageBreaks	Obtém uma coleção VPageBreaks que representa os intervalos de página verticais na planilha.

Métodos

Activate()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
BeginInit()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
CalculateMethod()	Calcula as fórmulas na planilha.
ChartObjects(Object)	Obtém um objeto que representa um único gráfico inserido (um ChartObject) ou uma coleção de todos os gráficos inseridos (um ChartObjects) na planilha.
CheckSpelling(Object, Object, Object, Object)	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
CircleInvalid()	Circula as entradas inválidas na planilha.
ClearArrows()	Limpa as setas de rastreamento da planilha. As setas de rastreamento são adicionadas usando o recurso de auditoria.
ClearCircles()	Apaga círculos de entradas inválidas na planilha.
Copy(Object, Object)	Copia a planilha para outro local na pasta de trabalho.
Delete()	Exclui o objeto Worksheet subjacente, mas não exclui o item de host. É altamente recomendável que esse método não seja usado.
Dispose()	Libera todos os recursos usados pela instância atual da classe WorksheetBase.
EndInit()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Evaluate(Object)	Converte um nome do Microsoft Office Excel em um objeto ou um valor.
ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)	Exportações para um arquivo do formato especificado.
FinishInitialization()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
GetAutomationObject()	Chamado pelo runtime do Visual Studio Tools para Office para obter um objeto que pode ser usado pelo código VBA na planilha.
Initialize()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
InitializeDataBindings()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Move(Object, Object)	Move a planilha para outro local na pasta de trabalho.
OLEObjects(Object)	Obtém um objeto que representa um objeto OLE único (um OLEObject) ou uma coleção de todos os objetos OLE (uma coleção de OLEObjects) na planilha.
OnShutdown()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
OnStartup()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Paste(Object, Object)	Cola o conteúdo da área de transferência na planilha.
PasteSpecial(Object, Object, Object, Object, Object, Object, Object)	Cola o conteúdo da área de transferência na planilha usando um formato especificado. Use esse método para colar dados de outros aplicativos ou para colar dados em um formato específico.
PivotTables(Object)	Obtém um objeto que representa um relatório de Tabela Dinâmica (um objeto PivotTable) ou uma coleção de todos os relatórios de Tabela Dinâmica (um objeto PivotTables) em uma planilha.
PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Cria um objeto PivotTable.
PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)	Imprime a planilha.
PrintPreview(Object)	Mostra uma visualização de como será a aparência da planilha quando ela for impressa.
Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Protege uma planilha para que ela não possa ser modificada.
ResetAllPageBreaks()	Redefine todas as quebras de página na planilha especificada.
SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Salva as alterações na planilha em um arquivo diferente.
Scenarios(Object)	Obtém um objeto que representa um único cenário (um objeto Scenario) ou uma coleção de cenários (um objeto Scenarios) na planilha.
Select(Object)	Seleciona a planilha.
SetBackgroundPicture(String)	Define o gráfico de tela de fundo da planilha.
ShowAllData()	Torna todas as linhas da lista filtrada no momento visíveis. Se o Filtro Automático estiver em uso, esse método mudará as setas para “Tudo”.
ShowDataForm()	Exibe o formulário de dados associado à planilha.
Unprotect(Object)	Remove a proteção da planilha. Esse método não surtirá efeito se a planilha não estiver protegida.
XmlDataQuery(String, Object, Object)	Obtém um objeto Range que representa as células mapeadas para um XPath específico. Obterá o `null` se o XPath especificado não tiver sido mapeado para a planilha ou se o intervalo mapeado estiver vazio.
XmlMapQuery(String, Object, Object)	Obtém um objeto Range que representa as células mapeadas para um XPath específico. Obterá o `null` se o XPath especificado não tiver sido mapeado para a planilha.

Eventos

ActivateEvent	Ocorre quando a planilha é ativada.
BeforeDoubleClick	Ocorre ao clicar duas vezes na planilha antes da ação de clique duplo padrão.
BeforeRightClick	Ocorre quando a planilha é clicada com o botão direito do mouse, antes da ação padrão de clique com o botão direito do mouse.
BindingContextChanged	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
Calculate	Ocorre depois que a planilha é recalculada.
Change	Ocorre quando há alguma alteração nas células WorksheetBase.
Deactivate	Ocorre quando a planilha perde o foco.
Disposed	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
FollowHyperlink	Ocorre quando você clica em qualquer hiperlink em uma planilha.
PivotTableAfterValueChange	Ocorre depois que uma célula ou um intervalo de células dentro de uma Tabela Dinâmica é editado ou recalculado (para células que contenham fórmulas). Esse evento só pode ser usado em projetos do Excel 2010.
PivotTableBeforeAllocateChanges	Ocorre antes das alterações serem aplicadas em uma Tabela Dinâmica. Esse evento só pode ser usado em projetos do Excel 2010.
PivotTableBeforeCommitChanges	Ocorre antes que as alterações sejam confirmadas junto à fonte de dados OLAP para uma Tabela Dinâmica. Esse evento só pode ser usado em projetos do Excel 2010.
PivotTableBeforeDiscardChanges	Ocorre antes das alterações feitas em uma Tabela Dinâmica serem descartadas. Esse evento só pode ser usado em projetos do Excel 2010.
PivotTableChangeSync	Ocorre após alterações feitas em uma Tabela Dinâmica. Esse evento só pode ser usado em projetos do Excel 2010.
PivotTableUpdate	Ocorre depois que um relatório de Tabela Dinâmica é atualizado em uma planilha.
SelectionChange	Ocorre quando a seleção muda em uma planilha.
Shutdown	Ocorre quando o item de host da planilha é desligado.
Startup	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.

Implantações explícitas de interface

EntryPoint.BeginInit()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.EndInit()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.FinishInitialization()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.Initialize()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.InitializeDataBindings()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.OnShutdown()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
EntryPoint.OnStartup()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
IExtension.ExtensionBase	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.
IWorksheetExtension.GetAutomationObject()	Fornece a classe base para as classes Sheetn nos projetos em nível de documento do Microsoft Office Excel.

Aplica-se a

Compartilhar via