Partilhar via


workbook Tipo de recurso de tabela

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma tabela do Excel.

Métodos

Método Tipo de retorno Descrição
List coleção WorkbookTable Obtenha a coleção de objetos da tabela.
Add WorkbookTable Crie uma nova tabela. O endereço de origem do intervalo determina a planilha à qual a tabela será adicionada. Se não for possível adicionar a tabela (por exemplo, porque o endereço é inválido ou a tabela se sobrepõe a outra tabela), é gerado um erro.
Get WorkbookTable Leia as propriedades e relações do objeto workbookTable.
Atualizar WorkbookTable Atualize o objeto workbookTable.
Delete Nenhum Exclui a tabela.
Colunas de lista coleção workbookTableColumn Obtenha uma lista de objetos workbookTableColumn.
Criar coluna WorkbookTableColumn Crie um novo livroTableColumn ao publicar na coleção de colunas.
List rows coleção workbookTableRow Obter uma coleção de objetos workbookTableRow.
Criar linha WorkbookTableRow Crie um novo livroTableRow ao publicar na coleção de linhas.
Obter intervalo do corpo de dados workbookRange Obtém o objeto workbookRange associado ao corpo de dados da tabela.
Obter intervalo de linhas de cabeçalho workbookRange Obtém o objeto workbookRange associado à linha de cabeçalho da tabela.
Obter intervalo de tabelas workbookRange Obtém o objeto workbookRange associado a toda a tabela.
Obter o intervalo total de linhas workbookRange Obtém o objeto workbookRange associado à linha de totais da tabela.
Limpar filtros Nenhum Limpa todos os filtros aplicados à tabela no momento.
Converter em intervalo workbookRange Converte a tabela em um intervalo de células normal. Todos os dados são preservados.
Voltar a aplicar filtros Nenhum Aplica novamente todos os filtros à tabela.

Propriedades

Propriedade Tipo Descrição
id cadeia de caracteres O identificador exclusivo da tabela no livro. O valor do identificador permanece o mesmo, ainda que a tabela seja renomeada. Esta propriedade deve ser interpretada como um valor de cadeia opaca e não deve ser analisada para qualquer outro tipo. Somente leitura.
name string O nome da tabela.
showHeaders Booliano Indica se a linha do cabeçalho está visível ou não. Esse valor pode ser definido para mostrar ou remover a linha do cabeçalho.
showTotals Booliano Indica se a linha do total está visível ou não. Esse valor pode ser definido para mostrar ou remover a linha do total.
style cadeia de caracteres Um valor constante que representa o estilo tabela. Os valores possíveis são: TableStyleLight1 através TableStyleLight21de , TableStyleMedium1 através TableStyleMedium28de , TableStyleStyleDark1 através de TableStyleStyleDark11. Também é possível usar um estilo definido pelo usuário que esteja presente na planilha.
highlightFirstColumn Booliano Indica se a primeira coluna contém uma formatação especial.
highlightLastColumn Booliano Indica se a última coluna contém uma formatação especial.
showBandedColumns Booliano Indica se as colunas mostram formatação em faixas nas quais as colunas ímpares são realçadas de modo diferente das colunas pares, tornando a leitura da tabela mais fácil.
showBandedRows Booliano Indica se as linhas mostram formatação em faixas nas quais as linhas ímpares são realçadas de modo diferente das colunas pares, tornando a leitura da tabela mais fácil.
showFilterButton Booliano Indica se os botões de filtro estão visíveis na parte superior de cada cabeçalho da coluna. Essa configuração só será permitida se a tabela tiver uma linha de cabeçalho.
legacyId Cadeia de caracteres Um identificador legado utilizado em clientes do Excel mais antigos. O valor do identificador permanece o mesmo, ainda que a tabela seja renomeada. Esta propriedade deve ser interpretada como um valor de cadeia opaca e não deve ser analisada para qualquer outro tipo. Somente leitura.

Relações

Relação Tipo Descrição
columns coleção workbookTableColumn A lista de todas as colunas na tabela. Somente leitura.
rows coleção workbookTableRow A lista de todas as linhas na tabela. Somente leitura.
sort WorkbookTableSort A ordenação da tabela. Somente leitura.
planilha WorkbookWorksheet A planilha que contém a tabela atual. Somente leitura.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "highlightFirstColumn": true,
  "highlightLastColumn": true,
  "id": "String (identifier)",
  "name": "String",
  "showBandedColumns": true,
  "showBandedRows": true,
  "showFilterButton": true,
  "showHeaders": true,
  "showTotals": true,
  "style": "String",
  "legacyId": "String"
}