Partilhar via

Amostras de código de suplemento do Office

  • Artigo

Esses exemplos de código são escritos para ajudá-lo a aprender como usar vários recursos ao desenvolver suplementos do Office.

Introdução

Os exemplos a seguir mostram como construir o Suplemento do Office mais simples com apenas um manifesto, página da web HTML e um logotipo. Esses componentes são as partes fundamentais de um Suplemento do Office. Para obter informações adicionais sobre os primeiros passos, consulte nossos primeiros passos e tutoriais.

Blazor WebAssembly

Se o seu fundo de desenvolvimento estiver na criação de Suplementos VSTO, os exemplos seguintes mostram como criar Suplementos Web do Office com o .NET Blazor WebAssembly. Pode manter grande parte do seu código em C# e Visual Studio.

Excel

Name Descrição
Explorador de tipos de dados (pré-visualização) Cria um suplemento do Excel que lhe permite criar e explorar tipos de dados nos seus livros. Os tipos de dados permitem aos programadores de suplementos organizar estruturas de dados complexas como objetos, tais como valores numéricos formatados, imagens Web e valores de entidade.
Abrir no Teams Crie uma nova planilha do Excel no Microsoft Teams contendo os dados que você definir.
Inserir um arquivo Excel externo e preenchê-lo com dados JSON Insira um modelo existente de um arquivo externo do Excel na pasta de trabalho do Excel aberta no momento. Em seguida, preencha o modelo com dados de um serviço Web JSON.
Crie guias contextuais personalizadas na faixa de opções Crie uma guia contextual personalizada na faixa de opções na interface do usuário do Office. O exemplo cria uma tabela e, quando o usuário move o foco dentro da tabela, a guia personalizada é exibida. Quando o usuário sai da tabela, a guia personalizada fica oculta.
Exemplo de função personalizada usando web worker Use web workers em funções personalizadas para evitar o bloqueio da interface do usuário do suplemento do Office.
Use técnicas de armazenamento para acessar dados de um suplemento do Office quando estiver offline Implemente o localStorage para habilitar a funcionalidade limitada do Suplemento do Office quando um usuário perder a conexão.
Padrão de lote de função personalizada Agrupe várias chamadas em uma única chamada para reduzir o número de chamadas de rede para um serviço remoto.

Outlook

Nome Descrição
Comunicar e-mails de spam ou phishing no Outlook Crie uma solução integrada de relatórios de spam que seja facilmente detetável no friso do cliente do Outlook. A solução fornece ao utilizador uma caixa de diálogo para comunicar um e-mail. Também guarda uma cópia do e-mail comunicado num ficheiro para processamento adicional no seu sistema de back-end.
Encriptar anexos, processar participantes de pedidos de reunião e reagir a alterações de data/hora de compromisso com a ativação baseada em eventos do Outlook Use a ativação baseada em evento para criptografar anexos quando adicionados pelo usuário. Use também o tratamento de eventos para destinatários alterados em uma solicitação de reunião e alterações na data ou hora de início ou término em uma solicitação de reunião.
Identificar e etiquetar destinatários externos com a ativação baseada em eventos do Outlook Use a ativação baseada em eventos para executar um suplemento do Outlook quando o usuário alterar os destinatários ao redigir uma mensagem. O suplemento também usa a API appendOnSendAsync para adicionar um aviso de isenção.
Definir a sua assinatura com a ativação baseada em eventos do Outlook Use a ativação baseada em eventos para executar um suplemento do Outlook quando o usuário criar uma nova mensagem ou compromisso. O suplemento pode responder a eventos, mesmo quando o painel de tarefas não está aberto. Ele também usa a API setSignatureAsync.
Verifique as categorias de cores de uma mensagem ou compromisso antes de ser enviado através de Alertas Inteligentes Use os Alertas Inteligentes do Outlook para verificar se as categorias de cores necessárias são aplicadas a uma nova mensagem ou compromisso antes de enviá-la.
Verificar a etiqueta de confidencialidade de uma mensagem Utilize a API de etiqueta de confidencialidade num suplemento baseado em eventos para verificar e aplicar a etiqueta de confidencialidade Altamente Confidencial às mensagens a enviar aplicáveis.

Word

Name Descrição
Obter, editar e definir conteúdo OOXML em um documento do Word com um suplemento do Word Este exemplo mostra como obter, editar e definir conteúdo OOXML em um documento do Word. O complemento de exemplo fornece um bloco de rascunho para obter o Office Open XML para seu próprio conteúdo e testar seus próprios trechos de código editados do Office Open XML.
Importar um modelo de documento Word com um suplemento Word Mostra como importar modelos num documento Word.
Carregar e gravar Open XML no seu suplemento do Word Este exemplo de suplemento mostra como adicionar uma variedade de tipos de conteúdos avançados a um documento do Word usando o método setSelectedDataAsync com tipo de coerção ooxml. O suplemento também oferece a capacidade de mostrar a marcação do Office Open XML para cada tipo de conteúdo de exemplo na página.
Gerir citações com o suplemento Word Mostra como gerir citações num documento Word.

Autenticação, autorização e logon único (SSO)

Nome Descrição
Suplemento do Office com SSO através da autenticação de aplicações aninhadas Mostra como utilizar MSAL.js autenticação de aplicações aninhadas (NAA) num Suplemento do Office para aceder às APIs do Microsoft Graph para o utilizador com sessão iniciada. O exemplo apresenta o nome e o e-mail do utilizador com sessão iniciada. Também insere os nomes dos ficheiros da conta do Microsoft OneDrive do utilizador no documento.
Suplemento do Outlook com SSO através da autenticação de aplicações aninhadas Mostra como utilizar MSAL.js autenticação de aplicações aninhadas (NAA) num Suplemento do Outlook para aceder às APIs do Microsoft Graph para o utilizador com sessão iniciada. O exemplo apresenta o nome e o e-mail do utilizador com sessão iniciada. Também insere os nomes dos ficheiros da conta do Microsoft OneDrive do utilizador num novo corpo de mensagem.
Utilizar o SSO com ativação baseada em eventos num suplemento do Outlook Mostra como utilizar o SSO para aceder aos dados do Microsoft Graph de um utilizador a partir de um evento acionado num suplemento do Outlook.
Suplemento de amostra do Outlook de logon único (SSO) Use o recurso SSO do Office para fornecer ao suplemento acesso aos dados do Microsoft Graph.
Obtenha dados do OneDrive usando Microsoft Graph e msal.js em um suplemento do Office Crie um suplemento do Office, como um aplicativo de página única (SPA) sem back-end, que se conecta ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para atualizar uma planilha.
Autenticação do suplemento do Office para o Microsoft Graph Aprenda a criar um suplemento do Microsoft Office que se conecte ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para atualizar uma planilha.
Autenticação do suplemento do Outlook para Microsoft Graph. Crie um suplemento do Outlook que se conecte ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para redigir uma nova mensagem de email.
Suplemento do Office de Logon único (SSO) com ASP.NET Use a API getAccessToken em Office.js para dar ao suplemento acesso aos dados do Microsoft Graph. Este exemplo é criado no ASP.NET.
Suplemento Office dee Logon único (SSO) com Node.js Use a API getAccessToken em Office.js para dar ao suplemento acesso aos dados do Microsoft Graph. Este exemplo é construído em Node.js.

Office

Nome Descrição
Guardar definições personalizadas no seu Suplemento do Office Guarde as definições personalizadas dentro de um Suplemento do Office. O suplemento armazena dados como pares chave-valor, utilizando a API JavaScript para o pacote de propriedades do Office, cookies do browser, armazenamento na Web (localStorage e sessionStorage) ou armazenando os dados num div oculto no documento.
Use os atalhos do teclado para ações do Suplemento do Office Crie atalhos de teclado personalizados para invocar determinadas ações para o seu Suplemento do Office.

Tempo de execução compartilhado

Nome Descrição
Compartilhe dados globais com um tempo de execução compartilhado Configure um projeto básico que usa o tempo de execução compartilhado para executar código para botões da faixa de opções, painel de tarefas e funções personalizadas em um único tempo de execução do navegador.
Gerencie a faixa de opções e a interface do usuário do painel de tarefas e execute o código no documento aberto Crie os botões contextuais da faixa de opções que são ativados com base no estado do seu suplemento.

Amostras adicionais

Nome Descrição
Use uma biblioteca compartilhada para migrar seu suplemento do Visual Studio Tools para Office para um suplemento da web do Office Fornece uma estratégia para reutilização de código ao migrar de suplementos do VSTO para suplementos do Office.
Integre uma função do Azure à sua função personalizada do Excel Integre funções do Azure com funções personalizadas para mover para a nuvem ou integrar serviços adicionais.
Amostras de código DPI dinâmico Uma coleção de amostras para lidar com alterações de DPI em suplementos COM, VSTO e Office.

Próximos passos

Adira ao Programa para Programadores do Microsoft 365 para obter recursos e informações para o ajudar a criar soluções para a plataforma do Microsoft 365, incluindo recomendações adaptadas às suas áreas de interesse.

Também pode ser elegível para uma subscrição de programador gratuita que seja renovável durante 90 dias e seja configurada com dados de exemplo; para obter detalhes, veja as FAQ.