Página de erro do Designer do Windows Forms (Windows Forms .NET)

  • Artigo

Se o Designer de Formulários do Windows não for carregado devido a um erro no 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 recolhí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 de um botão está ausente.

Janela de erro

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

  • Barra amarela

    A barra recolhí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 estes detalhes:

    • O arquivo em que o erro reside.
    • A coluna e a linha no arquivo em que o erro ocorre.
    • Um código de erro.
    • Uma descrição do erro.
    • Um link para navegar diretamente para o erro.

  • Instâncias desse 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ê-lo. Examinar a pilha de chamadas pode ajudá-lo a resolver o erro.

    Importante

    Os elementos de um erro podem variar de acordo com a 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.

  • Postagens do 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 pesquisar ou fazer uma pergunta nos fóruns do Microsoft Q&A ou do StackOverflow.

O que tentar primeiro

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

  1. Localize a janela Gerenciador de Soluções.
  2. Clique com o botão direito do mouse na solução ou no projeto e selecione Limpar.
  3. Clique com o botão direito do mouse na solução ou no projeto e selecione Recompilar.

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

Use a seção a seguir para fazer a triagem de erros comuns de tempo de design.

Erros comuns de tempo de design

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 ao excluir ou renomear um manipulador de eventos no arquivo code-behind que é referenciado pelo arquivo de designer. Abra o <formulário.designer>.<langauge> e exclua o manipulador de eventos do formulário ou controle.

'<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ê um nome exclusivo ao formulário herdado.

'<Nome> da guia da caixa de ferramentas' não é uma categoria da 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 ocorre devido a um erro que ocorreu durante a instalação. Entre em contato com o fornecedor do idioma que você está usando para obter uma correção.

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

Esse 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 '<nome do> documento' aberto em um 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 está com o arquivo aberto e tente novamente.

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

Feche e reabra o designer 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 dar suporte ao comportamento de recarregamento. 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

Essa 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 está com o arquivo aberto e tente novamente.

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

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

Não foi possível abrir o '<nome> do assembly' do assembly

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

Tipo de elemento defeituoso. Esse serializador espera um elemento do tipo '<type name>'

Esse 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 no momento

O Visual Studio fez uma chamada para a Caixa de Ferramentas, que não estava disponível. Se você vir esse erro, registre um problema usando Relatar um problema.

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

Esse erro geralmente surge quando você tenta conectar um evento a um controle herdado de uma classe base. Se a variável de membro do controle for privada, o Visual Studio não poderá conectar o evento ao método. Os controles herdados de forma privada não podem ter eventos extras associados 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

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

Não é possível nomear o objeto como '<nome>' porque ele já é chamado de '<nome>'

Esse erro é um erro interno no serializador do Visual Studio. Isso indica que o serializador tentou nomear um objeto duas vezes, o que não é suportado. Se você vir esse erro, registre um problema usando Relatar 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 herdada. As alterações no controle herdado devem ser feitas na classe da qual o controle se origina. Portanto, você não pode renomeá-lo ou destruí-lo.

A categoria 'Nome> da guia da< caixa de ferramentas' não possui uma ferramenta para a classe 'nome> da< classe'

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

A classe '<class name>' não tem construtor correspondente

Um designer de terceiros pediu ao Visual Studio para criar um objeto com parâmetros específicos no construtor que não existe. Entre em contato com o fornecedor do componente.

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

Esse erro é um invólucro genérico para um erro. A cadeia de caracteres de erro que acompanha essa 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, resolva o erro especificado na mensagem de erro anexada a esse erro.

O componente '<component name>' não chamou Container.Add() em seu construtor

Essa mensagem está relacionada a um erro no componente que você carregou ou colocou no formulário. Isso indica que o componente não se adicionou ao seu controle de contêiner (seja outro controle ou um formulário). O designer continua trabalhando, 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 IContainer.Add método no construtor do componente.

O nome do componente não pode estar vazio

Esse 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

Esse 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 os componentes.

Para corrigir esse erro, verifique se o código não tem uma dependência recursiva. Se estiver livre desses 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 'nome do< tipo>'

Mensagem de erro: "Não foi possível encontrar o tipo 'nome do< tipo>'. Certifique-se de que o assembly que contém esse tipo seja referenciado. Se esse tipo fizer parte do seu projeto de desenvolvimento, verifique se o projeto foi criado com êxito."

Esse erro ocorreu porque uma referência não foi encontrada. Verifique se o tipo indicado na mensagem de erro é referenciado e se todos os assemblies 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 Compilar Solução no menu Compilar . Caso contrário, se o controle já tiver sido criado, adicione uma referência manualmente no menu do botão direito do mouse da pasta Referências ou Dependências no Gerenciador de Soluções.

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

O 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. Esse 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 você vir esse erro, registre um problema usando Relatar um problema.

A classe delegada '<class name>' não tem método de invocação. Esta classe é um delegado

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

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

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

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

Esse erro pode ocorrer se houver um arquivo .resx inválido no projeto.

Para corrigir esse 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 resolver os erros.

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

Esse erro poderá ocorrer se houver um arquivo .resx inválido no projeto para a cultura padrão.

Para corrigir esse 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 resolver os erros.

Falha ao analisar 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: '<error string>'. Por favor, procure na Lista de Tarefas possíveis erros."

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 forma que ele esteja em conformidade com as regras de nomenclatura desse idioma.

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

Ao definir 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 de sua classe, exceto uma, do arquivo.

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

Esse erro é semelhante a "Não foi possível encontrar o tipo '<nome> do tipo'", mas esse erro geralmente ocorre devido a um atributo de metadados. Para corrigir esse erro, verifique se todos os assemblies usados por atributos são referenciados.

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

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

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

O 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 der suporte a um designer, verifique se não há 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 estejam corretas e que todos os nomes de classe estejam escritos corretamente. Caso contrário, se a classe não for projetável, edite-a na Visualização de código.

A classe base '<class name>' 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 Designer de Formulários do Windows.

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

O designer desse controle ou componente não dá suporte aos mesmos tipos que o Visual Studio. 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 a linguagem que está sendo usada. Para corrigir esse erro, nomeie a classe de forma que ela esteja em conformidade com os requisitos de idioma.

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

Você não pode 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

Esse erro ocorre quando o arquivo no editor é marcado como somente leitura. Certifique-se de que o arquivo não esteja marcado como somente leitura e que o aplicativo não esteja em execução.

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

Esse erro ocorre quando o Visual Studio não consegue encontrar uma classe base que atenda aos requisitos do designer. Formulários e controles devem derivar de uma classe base que dê suporte a designers. Se você estiver derivando de um formulário ou controle herdado, verifique se o projeto foi criado.

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

O Visual Studio não pôde carregar o designer para a classe. Se você vir esse erro, registre um problema usando Relatar um problema.

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

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

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

A classe base desse arquivo não dá suporte a nenhum designer. 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.

A linguagem desse arquivo não oferece suporte aos serviços de análise e geração de código necessários

Mensagem de erro: "O idioma deste arquivo não oferece suporte aos serviços de análise e geração de código necessários. Verifique se o arquivo que você está abrindo é membro de um projeto e tente abrir o arquivo 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 'nome> da< classe' não foi implementada corretamente

Mensagem de erro: "A classe do analisador de linguagem 'nome> da< classe' não foi 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 '<name>' já é usado por outro objeto

Esse é um erro interno no serializador do Visual Studio. Se você vir esse erro, registre um problema usando Relatar um problema.

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

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

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

Há algumas propriedades do .NET que sempre devem retornar um objeto. Por exemplo, a coleção Controls de um formulário deve sempre 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 dá suporte a esse designer, use o Editor de Códigos para fazer as alterações. Caso contrário, se você vir esse erro, registre um problema usando Relatar um problema.

A instância de serviço deve derivar ou implementar o '<nome> da interface'

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

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

O objeto enumerador Caixa de Ferramentas só dá suporte à recuperação de um item por vez

Se você vir esse erro, se você vir esse erro, registre um problema usando Relatar 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 gerou 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

Esse erro ocorrerá se os dados no item Caixa de ferramentas forem corrompidos ou se a versão do componente tiver sido alterada. Tente remover o item da Caixa de Ferramentas e adicioná-lo novamente.

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

Quando o designer é carregado, o Visual Studio não consegue encontrar um tipo. Verifique se o assembly que contém o tipo é referenciado. Se a montagem fizer parte do projeto de desenvolvimento atual, certifique-se de que o projeto tenha sido 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 do thread errado. Esse erro é exibido quando o código usado para criar o designer chamou o serviço de resolução de tipo de um thread diferente do thread principal do aplicativo. 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'

Esse erro surge se um designer de terceiros adiciona um comando que já tem um manipulador à 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 diferenciar maiúsculas de 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 há 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 nenhum componente 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 um retorno de chamada para um item em uma guia Caixa de Ferramentas, mas o item já continha um retorno de chamada. Entre em contato com o fornecedor do componente.

Esse mecanismo de linguagem não dá suporte a um CodeModel com o qual carregar um designer

Essa mensagem é semelhante a "A linguagem deste arquivo não oferece suporte aos serviços de análise e geração de código necessários", mas essa mensagem envolve um problema de registro interno. Se você vir esse erro, se você vir esse erro, registre um problema usando Relatar um problema.

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

O Visual Studio não conseguiu encontrar um construtor que tivesse parâmetros correspondentes. Esse erro pode ser o resultado do fornecimento de um construtor com tipos diferentes daqueles necessários. Por exemplo, um construtor Point pode usar dois inteiros. Se você forneceu tipos flutuantes, 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 o '<nome> de referência' de referência ao aplicativo atual

O Visual Studio não pode 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 fazer check-out do arquivo atual

Esse erro surge quando você altera um arquivo que está atualmente com check-in no controle de código-fonte. Normalmente, o Visual Studio apresenta a caixa de diálogo de check-out do arquivo para que o usuário possa fazer check-out do arquivo. Desta vez, o arquivo não foi verificado, 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 chamada 'Nome> da guia da< caixa de diálogo Opções'

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

Não é possível encontrar a propriedade 'nome> da< propriedade' na página 'Nome> da guia da< caixa de diálogo Opções'

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

O 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

O Visual Studio carregou a classe, mas o designer dessa 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 da classe para que seja a primeira classe no arquivo e carregue o designer novamente.

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

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

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

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

O Visual Studio não conseguiu encontrar um designer para classes do tipo '<type name>'

O 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.