Civil 3D API em C#: primeiros passos para programar o Civil 3D, do primeiro comando ao plugin

O Civil 3D é construído sobre o AutoCAD, e sua API também. Um programa para o Civil 3D usa duas camadas:

• A API do AutoCAD (.NET): documentos, transações, a linha de comando, linhas, polilinhas, blocos e layers.
• A API do Civil 3D (.NET): os objetos de engenharia: alinhamentos, perfis, superfícies, corredores, seções, pontos COGO, lotes e redes de tubulação.

As alternativas, conforme o que você precisa:

• Dynamo, para automatizar sem escrever código. Desde o Civil 3D 2025.1 traz mais de mil nós nativos; explicamos em 10 scripts de Dynamo para Civil 3D.
• Python, dentro dos nós de Python do Dynamo, quando os nós visuais não bastam.
• A API COM, mais antiga, que algumas rotinas LISP e VBA ainda usam.
• C# sobre a API .NET, para ferramentas de produção que o escritório inteiro usa. É o caminho deste guia.

1. Windows com o Civil 3D instalado. A API só funciona dentro do Civil 3D.
2. Visual Studio Community, gratuito, com a carga de trabalho de desenvolvimento desktop com .NET.
3. O framework certo para a sua versão:

4. Um projeto do tipo biblioteca de classes, com referências às bibliotecas da pasta de instalação do Civil 3D: AcCoreMgd, AcDbMgd e AcMgd, do AutoCAD, e AecBaseMgd e AeccDbMgd, do Civil 3D.

Este comando percorre os alinhamentos do desenho e escreve o nome e o comprimento de cada um na linha de comando:

using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.DatabaseServices;
using Autodesk.AutoCAD.EditorInput;
using Autodesk.AutoCAD.Runtime;
using Autodesk.Civil.ApplicationServices;
using Autodesk.Civil.DatabaseServices;

[assembly: CommandClass(typeof(ZeistDemo.Comandos))]

namespace ZeistDemo
{
    public class Comandos
    {
        [CommandMethod("ZLISTAREIXOS")]
        public void ListarEixos()
        {
            Document doc = Application.DocumentManager.MdiActiveDocument;
            Editor ed = doc.Editor;
            CivilDocument civil = CivilApplication.ActiveDocument;

            using (Transaction tr = doc.Database.TransactionManager.StartTransaction())
            {
                foreach (ObjectId id in civil.GetAlignmentIds())
                {
                    var eixo = (Alignment)tr.GetObject(id, OpenMode.ForRead);
                    ed.WriteMessage($"\n{eixo.Name}: {eixo.Length:F2} m");
                }
                tr.Commit();
            }
        }
    }
}

O que faz cada parte:

• CommandMethod transforma o método num comando que se digita no Civil 3D.
• CivilApplication.ActiveDocument dá acesso aos objetos do Civil 3D do desenho aberto.
• GetAlignmentIds() devolve os identificadores de todos os alinhamentos.
• A transação abre cada alinhamento para leitura, e Commit a encerra.

Para testar: compile, abra o Civil 3D com um desenho que tenha alinhamentos, digite NETLOAD, escolha sua DLL e execute ZLISTAREIXOS.

Quase tudo começa no CivilDocument, o documento do Civil 3D do desenho aberto:

De cada alinhamento chega-se aos seus perfis e grupos de linhas de amostragem; de cada corredor, às suas linhas base e regiões. A regra é sempre a mesma: obter o identificador, abrir o objeto dentro de uma transação e lê-lo ou modificá-lo.

• «Não foi possível carregar» ao fazer NETLOAD. O projeto aponta para um framework diferente do que a sua versão do Civil 3D usa. Confira a tabela do passo 2.
• Erros estranhos ao carregar ou fechar o Civil 3D. As referências da Autodesk ficaram com Copiar localmente em Sim.
• As mudanças não são salvas. Falta tr.Commit(): uma transação que não é confirmada é descartada inteira.
• Erro de bloqueio do documento (eLockViolation). Acontece quando o código roda a partir de uma janela própria e não de um comando: é preciso bloquear o documento antes de modificá-lo.
• Funciona na sua versão e não na do colega. Cada versão do Civil 3D exige compilar contra as próprias bibliotecas.

Um comando que funciona no seu computador ainda não é uma ferramenta. Para o escritório usar, é preciso:

• Um botão na barra superior do Civil 3D, em vez de um comando digitado.
• Um bundle: a pasta com formato oficial da Autodesk que o Civil 3D carrega sozinho ao iniciar.
• Tratamento de erros e registro do que faz, para que uma falha não deixe o desenho pela metade.
• Uma estrutura em camadas, para que a mudança de versão da Autodesk afete uma só parte do código.

Explicamos em desenvolvimento de add-ins para Revit e Civil 3D, e se você quer chegar mais rápido com IA, em criar um plugin do Civil 3D com Claude Code.