Compartilhar via


WorksheetBase Classe

Definição

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
WorksheetBase
Atributos
Implementações

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:

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