Página de erro do Windows Forms Designer

Se o Windows Forms Designer falhar ao carregar devido a um erro no seu código, em um componente de terceiros ou em outro lugar, uma página de erro será apresentada em vez do designer. Esta página de erro não significa necessariamente um bug no designer. O bug pode estar em algum lugar no arquivo code-behind. Os erros aparecem em barras amarelas dobráveis com um link para ir para o local do erro na página de código.

Uma guia de erro do designer no Visual Studio que diz que o evento para um botão está faltando.

Janela de erro

A janela de erro é composta por várias partes.

  • Barra amarela

    A barra dobrável amarela é criada para cada erro, agrupada por descrição. A barra descreve o erro do compilador que impede o designer de carregar a propriedade. Inclui os seguintes detalhes:

    • O arquivo no qual o erro reside.
    • A coluna e a linha no ficheiro onde ocorre o erro.
    • Um código de erro.
    • Uma descrição do erro.
    • Um link para aceder diretamente ao erro.

  • Instâncias deste erro

    Quando a barra de erro amarela é expandida, cada instância do erro é listada. Muitos tipos de erro incluem um local exato no seguinte formato: <nome do projeto><nome do formulário> Linha:<número da linha> Coluna:<número da coluna>. Se uma pilha de chamadas estiver associada ao erro, você poderá selecionar o link Mostrar pilha de chamadas para vê-la. Examinar a pilha de chamadas pode ajudá-lo ainda mais a resolver o erro.

    Importante

    Os elementos de um erro podem variar com base na linguagem de código que você está usando.

  • Ajuda com este erro

    Se um artigo de ajuda para o erro estiver disponível, selecione o link Ajuda do MSDN para navegar diretamente para a página de ajuda.

  • Publicações no fórum sobre este erro

    Selecione o link Pesquisar nos fóruns do MSDN por postagens relacionadas a esse erro para navegar até os fóruns antigos do Microsoft Developer Network. Você pode querer pesquisar ou fazer uma pergunta nos fóruns Microsoft Q&A ou StackOverflow.

O que experimentar primeiro

Muitas vezes, você pode limpar um erro limpando e reconstruindo o projeto ou a solução.

  1. Encontre a janela Explorador de Soluções.
  2. Clique com o botão direito do mouse na solução ou projeto e selecione Limpar.
  3. Clique com o botão direito do mouse na solução ou projeto e selecione Reconstruir.

Você também pode tentar excluir as pastas de bin e obj da pasta do projeto. Isso pode limpar um ficheiro temporário ou fazer com que uma ação de restauração aconteça, corrigindo uma dependência errónea.

Use a seção a seguir para analisar erros comuns durante o design.

Erros comuns em tempo de desenvolvimento

Esta seção lista alguns dos erros que você pode encontrar.

O nome '<nome>' não existe no contexto atual

Mais comumente, você vê esse erro quando exclui ou renomeia um manipulador de eventos no arquivo code-behind que é referenciado pelo arquivo de designer. Abra o arquivo de código do formulário <>.designer.<langauge> e elimine o manipulador de eventos do formulário ou do controlo.

'<nome do identificador>' não é um identificador válido

Esse erro indica que um campo, método, evento ou objeto está nomeado incorretamente.

<nome>' já existe em '<nome do projeto>'

Você especificou um nome para um formulário herdado que já existe no projeto. Para corrigir esse erro, dê ao formulário herdado um nome exclusivo.

'<Nome do separador Caixa de Ferramentas>' não é uma categoria de caixa de ferramentas

Um designer de terceiros tentou acessar uma guia na Caixa de Ferramentas que não existe. Entre em contato com o fornecedor do componente.

Um analisador de idioma solicitado não está instalado

O Visual Studio tentou carregar um designer registrado para o tipo de arquivo, mas não conseguiu. Isso é provavelmente devido a um erro que ocorreu durante a instalação. Entre em contato com o fornecedor do idioma que você está usando para uma correção.

Um serviço necessário para gerar e analisar o código-fonte está faltando

Este erro é um problema com um componente de terceiros. Entre em contato com o fornecedor do componente.

Ocorreu uma exceção ao tentar criar uma instância de '<nome do objeto>'

Um designer de terceiros solicitou que o Visual Studio criasse um objeto, mas o objeto gerou um erro. Entre em contato com o fornecedor do componente.

Outro editor tem o documento '<nome do documento>' aberto num modo incompatível.

Este erro surge se você tentar abrir um arquivo que já está aberto em outro editor. O editor que já tem o arquivo aberto é mostrado. Para corrigir esse erro, feche o editor que tem o arquivo aberto e tente novamente.

Outro editor fez alterações em '<nome do documento>'

Feche e reabra o editor para que as alterações entrem em vigor. Normalmente, o Visual Studio recarrega automaticamente um designer depois que as alterações são feitas. No entanto, outros designers, como designers de componentes de terceiros, podem não oferecer suporte ao comportamento de recarga. Nesse caso, o Visual Studio solicita que você feche e reabra o designer manualmente.

Outro editor tem o arquivo aberto em um modo incompatível

Esta mensagem é semelhante a "Outro editor tem '<nome do documento>' aberto em um modo incompatível", mas o Visual Studio não consegue determinar o nome do arquivo. Para corrigir esse erro, feche o editor que tem o arquivo aberto e tente novamente.

A classificação '<classificação na matriz>' é muito alta

O Visual Studio oferece suporte apenas a matrizes de dimensão única no bloco de código analisado pelo designer. Matrizes multidimensionais são válidas fora desta área.

Assembly '<nome do assembly>' não pôde ser aberto

Essa mensagem de erro surge quando você tenta abrir um arquivo que não pôde ser aberto. Verifique se o ficheiro existe e é uma assemblagem válida.

Tipo de elemento incorreto. Este serializador espera um elemento do tipo '<nome do tipo>'

Este erro é um problema com um componente de terceiros. Entre em contato com o fornecedor do componente.

Não é possível acessar a caixa de ferramentas do Visual Studio neste momento

O Visual Studio fez uma invocação para a Caixa de Ferramentas, que não estava disponível. Se vir este erro, registe um problema utilizando Comunicar um problema.

Não é possível vincular um manipulador de eventos ao evento '<nome do evento>' porque o evento é de leitura apenas

Esse erro geralmente surge quando você tentou conectar um evento a um controle herdado de uma classe base. Se a variável membro do controle for privada, o Visual Studio não poderá conectar o evento ao método. Os controles herdados em particular não podem ter eventos extras vinculados a eles.

Não é possível criar um nome de método para o componente solicitado porque ele não é um membro do contêiner de design

Visual Studio tentou adicionar um manipulador de eventos a um componente que não tem uma variável membro no designer. Entre em contato com o fornecedor do componente.

Não é possível nomear o objeto '<nome>' porque ele já está nomeado '<nome>'

Este erro é um erro interno no serializador do Visual Studio. Ele indica que o serializador tentou nomear um objeto duas vezes, o que não é suportado. Se vir este erro, registe um problema utilizando Comunicar um problema.

Não é possível remover ou destruir o componente herdado '<nome do componente>'

Os controles herdados estão sob a propriedade de sua classe herdeira. As alterações ao controlo herdado devem ser efetuadas na classe de onde provém o controlo. Assim, você não pode renomeá-lo ou destruí-lo.

Categoria '<Caixa de Ferramentas, nome da guia>' não possui ferramenta para a classe '<nome da classe>'

O designer tentou fazer referência a uma classe em uma guia Toolbox específica, mas a classe não existe. Entre em contato com o fornecedor do componente.

Classe '<nome da classe>' não tem construtor correspondente

Um designer de terceiros pediu ao Visual Studio para criar um objeto com determinados parâmetros no construtor, mas tal objeto não existe. Entre em contato com o fornecedor do componente.

Falha na geração de código para a propriedade '<nome da propriedade '>'

Este erro é um wrapper genérico para um erro. A cadeia de caracteres de erro que acompanha esta mensagem fornece mais detalhes sobre a mensagem de erro e tem um link para um artigo de ajuda mais específico. Para corrigir esse erro, corrija o erro especificado na mensagem de erro anexada a esse erro.

Componente '<nome do componente>' não chamou Container.Add() em seu construtor

Esta mensagem está relacionada a um erro no componente que você carregou ou colocou no formulário. Ele indica que o componente não se adicionou ao seu controle de contêiner (seja outro controle ou um formulário). O designer continua a trabalhar, mas pode haver problemas com o componente em tempo de execução.

Para corrigir o erro, entre em contato com o fornecedor do componente. Ou, se for um componente que você criou, chame o método IContainer.Add no construtor do componente.

O nome do componente não pode estar vazio

Este erro surge quando você tenta renomear um componente para um valor vazio.

Não foi possível acessar a variável '<nome da variável>' porque ela ainda não foi inicializada

Este erro pode surgir devido a dois cenários. Um fornecedor de componentes de terceiros tem um problema com um controle ou componente que distribuiu, ou o código que você escreveu tem dependências recursivas entre componentes.

Para corrigir esse erro, verifique se o código não tem uma dependência recursiva. Se estiver livre de tais problemas, anote o texto exato da mensagem de erro e entre em contato com o fornecedor do componente.

Não foi possível encontrar o tipo '<tipo nome>'

Mensagem de erro: "Não foi possível encontrar o tipo '<tipo de nome>'. Certifique-se de que o conjunto que contém este tipo é referenciado. Se este tipo fizer parte do seu projeto de desenvolvimento, certifique-se de que o projeto foi construído com sucesso."

Este erro ocorreu porque uma referência não foi encontrada. Certifique-se de que o tipo indicado na mensagem de erro é referenciado e de que todos os conjuntos que o tipo requer também são referenciados. Muitas vezes, o problema é que um controle na solução não foi construído. Para compilar, selecione Construir Solução no menu Construir. Caso contrário, se o controlo já tiver sido criado, adicione uma referência manualmente a partir do menu do botão direito da pasta Referências ou Dependências no Explorador de Soluções.

Não foi possível carregar o tipo '<nome do tipo>'

Visual Studio tentou conectar um método de manipulação de eventos e não conseguiu encontrar um ou mais tipos de parâmetro para o método. Este erro é geralmente causado por uma referência ausente. Para corrigir esse erro, adicione a referência que contém o tipo ao projeto e tente novamente.

Não foi possível localizar os modelos de item de projeto para componentes herdados

Os modelos para formulários herdados no Visual Studio não estão disponíveis. Se vir este erro, registe um problema utilizando Comunicar um problema.

A classe delegada '<nome da classe>' não tem um método invoke. Esta classe é um delegado?

Visual Studio tentou criar um manipulador de eventos, mas há algo errado com o tipo de evento. Este erro pode acontecer se o evento foi criado por uma linguagem não compatível com CLS. Entre em contato com o fornecedor do componente.

Declaração duplicada do membro '<nome de membro>'

Este erro surge porque uma variável membro foi declarada duas vezes (por exemplo, dois controles chamados Button1 são declarados no código). Os nomes devem ser exclusivos em todos os formulários herdados. Além disso, os nomes não podem diferir apenas por maiúsculas e minúsculas.

Erro ao ler os recursos do ficheiro de recursos para a cultura '<nome da cultura>'

Este erro pode ocorrer se houver um arquivo .resx incorreto no projeto.

Para corrigir este erro:

  1. Selecione o botão Mostrar Todos os Arquivos no Gerenciador de Soluções para exibir os arquivos .resx associados à solução.
  2. Carregue o arquivo .resx no Editor XML clicando com o botão direito do mouse no arquivo .resx e escolhendo Abrir.
  3. Edite o arquivo .resx manualmente para corrigir os erros.

Erro ao ler recursos do arquivo de recurso para a cultura padrão '<nome da cultura>'

Este erro pode ocorrer se houver um arquivo .resx incorreto no projeto para a cultura padrão.

Para corrigir este erro:

  1. Selecione o botão Mostrar Todos os Arquivos no Gerenciador de Soluções para exibir os arquivos .resx associados à solução.
  2. Carregue o arquivo .resx no Editor XML clicando com o botão direito do mouse no arquivo .resx e escolhendo Abrir.
  3. Edite o arquivo .resx manualmente para corrigir os erros.

Não foi possível interpretar o método '<nome do método>'

Mensagem de erro: "Falha ao analisar o método '<nome do método>'. O analisador relatou o seguinte erro: '<mensagem de erro>'. Por favor, procure possíveis erros na Lista de Tarefas."

Esta é uma mensagem de erro geral para problemas que surgem durante a análise. Esses erros geralmente são devidos a erros de sintaxe. Consulte a Lista de tarefas para obter mensagens específicas relacionadas ao erro.

Nome do componente inválido: '<nome do componente>'

Você tentou renomear um componente para um valor inválido para esse idioma. Para corrigir esse erro, nomeie o componente de modo que ele esteja em conformidade com as regras de nomenclatura para esse idioma.

O tipo '<nome da classe>' é feito de várias classes parciais no mesmo arquivo

Quando você define uma classe em vários arquivos usando a palavra-chave parcial , você só pode ter uma definição parcial em cada arquivo.

Para corrigir esse erro, remova todas as definições parciais da sua classe, exceto uma, do arquivo.

O assemblage '<nome do assembly>' não pôde ser encontrado

Este erro é semelhante a "O tipo '<nome do tipo>' não pôde ser encontrado", mas esse erro geralmente acontece devido a um atributo de metadados. Para corrigir esse erro, verifique se todos os assemblies usados pelos atributos são referenciados.

O nome do assembly '<>' é inválido

Um componente solicitou um conjunto específico, mas o nome fornecido pelo componente não é um nome de conjunto válido. Entre em contato com o fornecedor do componente.

A classe base '<nome da classe>' não pode ser desenvolvida

Visual Studio carregou a classe, mas a classe não pode ser projetada porque o implementador da classe não forneceu um designer. Se a classe oferecer suporte a um designer, certifique-se de que não haja problemas que possam causar problemas com a exibição em um designer, como erros do compilador. Além disso, certifique-se de que todas as referências à classe estão corretas e todos os nomes de classe estão escritos corretamente. Caso contrário, se a classe não for projetável, edite-a na Visualização de código.

A classe base '<nome da classe>' não pôde ser carregada

A classe não é referenciada no projeto, portanto, o Visual Studio não pode carregá-la. Para corrigir esse erro, adicione uma referência à classe no projeto e feche e reabra a janela do Windows Forms Designer.

A classe '<nome da classe>' não pode ser projetada nesta versão do Visual Studio

O designer para esse controle ou componente não oferece suporte aos mesmos tipos que o Visual Studio faz. Entre em contato com o fornecedor do componente.

O nome da classe não é um identificador válido para este idioma

O código-fonte criado pelo usuário tem um nome de classe que não é válido para o idioma que está sendo usado. Para corrigir esse erro, nomeie a classe de modo que ela esteja em conformidade com os requisitos de idioma.

O componente não pode ser adicionado porque contém uma referência circular a '<nome de referência>'

Não é possível adicionar um controle ou componente a si mesmo. Outra situação em que isso pode ocorrer é se houver código no método InitializeComponent de um formulário (por exemplo, Form1) que cria outra instância de Form1.

O designer não pode ser modificado neste momento

Este erro ocorre quando o arquivo no editor é marcado como somente leitura. Verifique se o arquivo não está marcado como somente leitura e se o aplicativo não está em execução.

O designer não pôde ser mostrado para este arquivo porque nenhuma das classes dentro dele pode ser projetada

Este erro ocorre quando o Visual Studio não consegue encontrar uma classe base que satisfaça os requisitos do designer. Formulários e controles devem derivar de uma classe base que ofereça suporte a designers. Se você estiver derivando de um formulário ou controle herdado, certifique-se de que o projeto foi construído.

O designer para a classe base '<class name>' não está instalado

Visual Studio não pôde carregar o designer para a classe. Se vir este erro, registe um problema utilizando Comunicar um problema.

O designer deve criar uma instância do tipo '<nome do tipo>', mas não pode porque o tipo é declarado como abstrato

Este erro ocorreu porque a classe base do objeto que está sendo passado para o designer é abstrato, o que não é permitido.

O arquivo não pôde ser carregado no designer

A classe base deste ficheiro não suporta quaisquer designers. Como solução alternativa, use a Visualização de código para trabalhar no arquivo. Clique com o botão direito do mouse no arquivo no Gerenciador de Soluções e escolha Exibir Código.

O idioma para este arquivo não suporta os serviços de análise e geração de código necessários

Mensagem de erro: "O idioma para este ficheiro não suporta os serviços de análise e geração de código necessários. Certifique-se de que o ficheiro que está a abrir é membro de um projeto e, em seguida, tente abri-lo novamente."

Esse erro provavelmente resultou da abertura de um arquivo que está em um projeto que não oferece suporte a designers.

A classe do analisador de linguagem '<class name>' não está implementada corretamente

Mensagem de erro: "A classe do analisador de idiomas '<nome da classe>' não está implementada corretamente. Entre em contato com o fornecedor para obter um módulo analisador atualizado."

A linguagem em uso registrou uma classe de designer que não deriva da classe base correta. Entre em contato com o fornecedor do idioma que você está usando.

O nome '<nome>' já é usado por outro objeto

Este é um erro interno no serializador do Visual Studio. Se vir este erro, registe um problema utilizando Comunicar um problema.

O objeto '<nome do objeto>' não implementa a interface IComponent

Visual Studio tentou criar um componente, mas o objeto criado não implementa a interface IComponent. Entre em contato com o fornecedor do componente para obter uma correção.

O objeto '<nome do objeto>' retornou null para a propriedade '<nome da propriedade>' mas isso não é permitido

Há algumas propriedades .NET que sempre devem retornar um objeto. Por exemplo, o Controls coleção de um formulário sempre deve retornar um objeto, mesmo quando não há controles nele.

Para corrigir esse erro, verifique se a propriedade especificada no erro não é nula.

O objeto de dados de serialização não é do tipo adequado

Um objeto de dados oferecido pelo serializador não é uma instância de um tipo que corresponde ao serializador atual que está sendo usado. Entre em contato com o fornecedor do componente.

O serviço '<nome do serviço>' é necessário, mas não pôde ser localizado

Um serviço exigido pelo Visual Studio não está disponível. Se você tentou carregar um projeto que não suporta esse designer, use o Editor de Códigos para fazer as alterações. Caso contrário, se vir este erro, registe um problema utilizando Comunicar um problema.

A(s) instância(s) de serviço deve(m) derivar ou implementar a interface denominada '<>'

Esse erro indica que um componente ou designer de componente chamou o método AddService, que requer uma interface e um objeto, mas o objeto especificado não implementa a interface especificada. Entre em contato com o fornecedor do componente.

O texto na janela de código não pôde ser modificado

Este erro ocorre quando o Visual Studio não consegue editar um ficheiro devido a problemas de espaço em disco ou memória, ou o ficheiro está marcado como só de leitura.

O objeto enumerador Toolbox suporta apenas a recuperação de um item de cada vez

Se vir este erro, por favor, registe um problema utilizando Comunicar um problema.

O item da Caixa de Ferramentas para '<nome do componente>' não pôde ser recuperado da Caixa de Ferramentas.

O componente em questão lançou uma exceção quando o Visual Studio o acessou. Entre em contato com o fornecedor do componente.

O item da Caixa de Ferramentas para '<Nome do item da Caixa de Ferramentas>' não pôde ser recuperado da Caixa de Ferramentas

Este erro ocorre se os dados dentro do item caixa de ferramentas ficar corrompido ou a versão do componente foi alterada. Tente remover o item da Caixa de Ferramentas e adicioná-lo novamente.

O tipo '<nome do tipo>' não pôde ser encontrado

Quando o designer é carregado, Visual Studio não conseguiu localizar um tipo. Certifique-se de que o conjunto que contém o tipo esteja referenciado. Se a montagem fizer parte do projeto de desenvolvimento atual, certifique-se de que o projeto foi construído.

O serviço de resolução de tipo só pode ser chamado a partir do thread principal do aplicativo

O Visual Studio tentou acessar os recursos necessários a partir do thread errado. Este erro é apresentado quando o código usado para criar o designer chamou o serviço de resolução de tipo a partir de um processo diferente do processo principal da aplicação. Para corrigir esse erro, chame o serviço do thread correto ou entre em contato com o fornecedor do componente.

A variável '<nome da variável>' não é declarada ou nunca foi atribuída

O código-fonte tem uma referência a uma variável, como Button1, que não é declarada ou atribuída. Se a variável não tiver sido atribuída, essa mensagem aparecerá como um aviso, não como um erro.

Já existe um manipulador de comandos para o comando de menu '<nome do comando de menu>'

Este erro surge se um designer de terceiros adiciona um comando que já tem um manipulador para a tabela de comandos. Entre em contato com o fornecedor do componente.

Já existe um componente chamado '<nome do componente>'

Mensagem de erro: "Já existe um componente chamado '<nome do componente>'. Os componentes devem ter nomes exclusivos e os nomes não devem ser sensíveis a maiúsculas e minúsculas. Um nome também não pode entrar em conflito com o nome de qualquer componente em uma classe herdada."

Essa mensagem de erro surge quando houve uma alteração no nome de um componente na janela Propriedades. Para corrigir esse erro, certifique-se de que todos os nomes de componentes sejam exclusivos, não diferenciem maiúsculas de minúsculas e não entrem em conflito com os nomes de quaisquer componentes nas classes herdadas.

Já existe um criador de itens da caixa de ferramentas registrado para o formato '<nome do formato>'.

Um componente de terceiros fez uma chamada de retorno para um item num separador da Caixa de Ferramentas, mas o item já continha uma chamada de retorno. Entre em contato com o fornecedor do componente.

Este mecanismo de linguagem não suporta um CodeModel com o qual carregar um designer

Esta mensagem é semelhante a "O idioma para este ficheiro não suporta os serviços de análise e geração de código necessários", mas esta mensagem envolve um problema de registo interno. Se vir este erro, por favor, registe um problema utilizando Comunicar um problema.

Tipo '<nome do tipo>' não possui um construtor com parâmetros dos tipos '<nomes de tipo de parâmetro>'

Visual Studio não pôde encontrar um construtor que tinha parâmetros correspondentes. Este erro pode ser o resultado de fornecer a um construtor tipos diferentes daqueles que são necessários. Por exemplo, um construtor de Point pode ter dois números inteiros. Se você forneceu tipos de flutuação, esse erro será gerado.

Para corrigir esse erro, use um construtor diferente ou converta explicitamente os tipos de parâmetro de modo que eles correspondam aos fornecidos pelo construtor.

Não é possível adicionar a referência '<nome de referência>' ao aplicativo atual

Não é possível para o Visual Studio adicionar uma referência. Para corrigir esse erro, verifique se uma versão diferente da referência ainda não está referenciada.

Não é possível acessar o arquivo atual

Este erro surge quando se altera um ficheiro que está atualmente integrado no sistema de controlo de código-fonte. Normalmente, o Visual Studio apresenta a caixa de diálogo de extração do ficheiro para que o utilizador possa fazer a extração do ficheiro. Desta vez, o arquivo não foi submetido a check-out, talvez devido a um conflito de mesclagem durante o check-out. Para corrigir esse erro, verifique se o arquivo não está bloqueado e tente fazer check-out do arquivo manualmente.

Não é possível encontrar a página com o nome '<nome do separador da caixa de diálogo Opções>'

Este erro surge quando um designer de componentes solicita acesso a uma página a partir da caixa de diálogo Opções usando um nome que não existe. Entre em contato com o fornecedor do componente.

Não foi possível encontrar a propriedade '<nome da propriedade>' no separador '<nome da guia da caixa de diálogo Opções>'

Esse erro surge quando um designer de componente solicita acesso a um valor específico em uma página da caixa de diálogo Opções, mas esse valor não existe. Entre em contato com o fornecedor do componente.

Visual Studio não pode abrir um designer para o arquivo porque a classe dentro dele não herda de uma classe que pode ser projetada visualmente

Visual Studio carregou a classe, mas o designer para essa classe não pôde ser carregado. O Visual Studio requer que os designers usem a primeira classe em um arquivo. Para corrigir esse erro, mova o código de classe para que seja a primeira classe no arquivo e, em seguida, carregue o designer novamente.

Visual Studio não pode salvar ou carregar instâncias do tipo '<nome do tipo>'

Este problema está relacionado com um componente de terceiros. Entre em contato com o fornecedor do componente.

Visual Studio não consegue abrir '<nome do documento>' no modo Design

Este erro indica que o idioma do projeto não suporta um designer e surge quando você tenta abrir um arquivo na caixa de diálogo Abrir arquivo ou do Gerenciador de Soluções. Em vez disso, edite o arquivo na Visualização de código.

Visual Studio não pôde encontrar um designer para as classes de tipo '<nome do tipo>'

Visual Studio carregou a classe, mas a classe não pode ser projetada. Em vez disso, edite a classe na Visualização de código clicando com o botão direito do mouse na classe e escolhendo Exibir código.

  • Last updated on