Share via

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

  • Artigo

Se o Windows Forms Designer 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 saltar para o local do erro na página de código.

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

Importante

A documentação do Guia da Área de Trabalho para .NET 7 e .NET 6 está em construção.

Barra amarela

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

  • O erro de arquivo reside em.
  • A coluna e a linha no arquivo onde o erro ocorre.
  • Um código de erro.
  • Uma descrição do erro.
  • Um link para navegar diretamente para o 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 no idioma do 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 de Perguntas e Respostas da Microsoft ou StackOverflow

Erros comuns em 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 quando exclui ou renomeia um manipulador de eventos no arquivo code-behind que é referência pelo arquivo de designer. Abra o <form.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ê ao formulário herdado um nome exclusivo.

'<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 se deve 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

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 '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 tem 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 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

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 tem o arquivo aberto e tente novamente.

A classificação da matriz '<rank in array>' é 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 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 é um assembly válido.

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

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 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 vincular 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. Controles herdados de forma privada 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 de membro no designer. Entre em contato com o fornecedor do componente.

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

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 de herança. As alterações no controle herdado devem ser feitas na classe da qual o controle se origina. Assim, você não pode renomeá-lo ou destruí-lo.

A categoria 'Nome da guia> da< caixa de ferramentas' não tem uma 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.

A classe 'nome> da< classe' 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'

Este erro é um wrapper 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 'nome do<> componente' 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. 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 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 componentes.

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

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

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

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'

Visual Studio tentou conectar um método de manipulação de eventos e não conseguiu localizar 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 'nome> da< classe' não tem nenhum método de invocação. Esta classe é um delegado?

Visual Studio tentou criar um manipulador de eventos, mas há algo errado com o tipo de evento. Esse 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.

Segunda via da declaração do «<nome> do membro»

Esse erro ocorre porque uma variável de membro foi declarada duas vezes (por exemplo, dois controles nomeados Button1 são declarados no código). Os nomes devem ser exclusivos em formulários herdados. 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 incorreto 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 de 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'

Esse erro pode ocorrer se houver um arquivo .resx incorreto 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 de 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.

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: 'sequência< de erro>'. 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 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, exceto uma das definições parciais de sua classe do arquivo.

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

Esse 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 '<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

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, verifique se não há problemas que possam causar problemas com a exibição dela 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 designá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 criada nesta versão do Visual Studio

O designer para esse controle ou componente não oferece 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 o idioma que está sendo usado. 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'

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 do Form1.

O designer não pode ser modificado no momento

Esse 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

Esse erro ocorre quando o Visual Studio não consegue localizar uma classe base que satisfaz os requisitos de 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, verifique se o projeto foi criado.

O designer para a classe base 'nome> da< classe' não está instalado

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 deste arquivo não oferece 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.

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

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

Mensagem de erro: "A classe do analisador de idioma '<nome da> classe' não está implementada corretamente. Entre em contato com o fornecedor para obter um módulo de 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 você vir esse erro, registre um problema usando Relatar um problema.

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

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 null 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 houver 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' é obrigató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 oferece 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 '<nome> da interface'

Esse erro indica que um designer de componente ou 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 oferece suporte apenas à 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 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

Esse erro ocorre se os dados dentro do item Caixa de ferramentas ficar corrompido ou 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 conseguiu localizar um tipo. Certifique-se de que o assembly que contém o tipo seja referenciado. Se a montagem fizer parte do projeto de desenvolvimento atual, verifique se o projeto foi construído.

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

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 do aplicativo principal. 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 foi 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 houve uma alteração no nome de um componente na janela Propriedades. Para corrigir esse erro, verifique se todos os nomes de componentes são exclusivos, não diferenciam maiúsculas de minúsculas e não entram em conflito com os nomes de nenhum componente nas classes herdadas.

Já existe um criador de itens do Toolbox registrado para o formato '<format name>'

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 oferece suporte a um CodeModel com o qual carregar um designer

Essa mensagem é semelhante a "O idioma para este arquivo não oferece suporte aos serviços de geração e análise 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.

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

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

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

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

Visual Studio não é possível 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 para o controle do 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, não foi feito check-out do arquivo, 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 localizar a página chamada 'Nome da guia da caixa de diálogo Opções<>'

Esse erro surge quando um designer de componente 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 localizar 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 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 visualmente projetada

Visual Studio carregou a classe, mas o designer para essa classe não pôde ser carregado. Visual Studio requer que os designers usam 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 é possível 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.

Visual Studio não é possível abrir '<nome> do documento' no modo Design

Esse erro indica que o idioma do projeto não oferece 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.

Visual Studio não conseguiu localizar um designer para classes do 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.