Renomear

Renomear é um recurso de refatoração no ambiente de desenvolvimento integrado (IDE) do Visual Studio que oferece uma maneira fácil para renomear identificadores para símbolos de código sistema autônomo campos, variáveis locais, métodos, namespaces, propriedades e tipos.Renomear pode ser usado para alterar os nomes em comentários e cadeias de caracteres e alterar as declarações e chamadas de um identificador.

Observação:
Ao usar o controle de fonte para o Visual Studio, obter a versão mais recente das fontes antes de tentar executar a renomeação Refatoração .

Renomeação de refatoração está disponível nos seguintes recursos do Visual Studio:

Recurso	Comportamento de refatoração no IDE
Editor de códigos	No Editor de código, refatoração Renomear está disponível quando você posicionar o cursor em determinados tipos de símbolos de código.Quando o cursor está nesta posição, você pode chamar o Renomear comando digitando o atalho de teclado (CTRL + R, R), ou selecionando o Renomear comando a , menu de atalho ou uma marca SMARTrefatorar menu.Quando você chamar o Renomear o comandoRenomear caixa de diálogo é exibida.Para obter mais informações, consulte Caixa de diálogo Renomear e Como: Renomear identificadores.
Modo de Exibição de Classe	Quando você selecionar um identificador em classe View, renomeação de refatoração estiver disponível no menu de atalho e refatorar menu.
Pesquisador de Objetos	Quando você seleciona um identificador no Pesquisador de objetos, a renomeação de refatoração só está disponível no refatorar menu.
Grade de propriedade do Designer de Formulários do Windows	No Grade de propriedade do Designer de Formulários do Windows, a alteração do nome de um controle iniciará uma operação de renomeação desse controle.The Renomear caixa de diálogo não aparecerá.
Gerenciador de Soluções	In O gerenciador de soluções, a Renomear comando está disponível no menu de atalho.Se o arquivo de fonte selecionado contém um clsistema autônomos cujo nome clsistema autônomos é o mesmo sistema autônomo o nome de arquivo, você pode usar esse comando para renomear o arquivo de fonte e executar a refatoração Renomear simultaneamente. Por exemplo, se você criar um aplicativos do Windows padrão e, em seguida, renomeie Form1.cs para TestForm.cs, o arquivo de fonte nome Form1.cs será alterado para TestForm.cs e a classe Form1 e todas as referências a essa classe será renomeado como TestForm. Observação: O Desfazercomando (CTRL+Z) somente irá desfazer a renomeação de refatoração do código e não alterará nome de arquivo de volta ao nome original. Se o arquivo de fonte selecionado não contém uma classe cujo nome é igual ao nome de arquivo, a Renomear comando O gerenciador de soluções só serão renomear o arquivo de fonte e que não serão executar renomear refatoração.

Operações de renomeação

Quando você executa Renomear, o mecanismo de refatoração realiza uma determinada operação de renomeação de cada símbolo de código, descrita na tabela a seguir.

Símbolo de código	Operação de renomeação
Campo	Altera a declaração e usos do campo para o novo nome.
Variável local	Altera a declaração e usos da variável para o novo nome.
Método	Altera o nome do método e todas as referências a esse método para o novo nome. Observação: Quando você renomear um método de extensão , a renomeação operação propagar s para todas sistema autônomo instâncias do método que estão no escopo, independentemente de se o método de extensão está sendo usado sistema autônomo um método estático ou um método de instância.Para obter mais informações, consulte Métodos de extensão (Guia de programação C#).
Namespace	Altera o nome do namespace para o novo nome na declaração, todos os using instruções e os nomes totalmente qualificados. Observação: Ao renomear um espaço para nome Visual Studio também atualiza o Namespace padrão propriedade a Aplicativo página de do Designer de projeto.Não é possível reiniciar essa propriedade selecionando Desfazer from the edição menu.Para reiniciar o Namespace padrão valor da propriedade, você deve modificar a propriedade no Designer de projeto.Para obter mais informações, consulte Página de aplicativo.
Propriedade	Altera a declaração e usos da propriedade para o novo nome.
Type (Tipo)	Altera todas as declarações e todos os usos do tipo para o novo nome, incluindo construtores e destrutores.Para tipos parcial, a operação de renomeação propagará para todas as partes.

Comentários

Renomeando implementado ou substituídos membros

Quando Renomear um membro que substitui/implementa ou é implementado/substituídos por membros em outros tipos, Visual Studio Exibe uma caixa de diálogo que diz que a operação de renomeação causará atualizações em cascata. Se você clicar em Continuar, a refatoração recursivamente mecanismo localiza e renomeia todos os membros em tipos de básicos e derivados têm substitui/implementa relação com o membro que está sendo renomeado.

O exemplo de código a seguir contém os membros com relação substitui/implementa.

interface IBase
{
    void Method();
}
public class Base
{
    public void Method()
    { }
    public virtual void Method(int i)
    { }
}
public class Derived : Base, IBase
{
    public new void Method()
    { }
    public override void Method(int i)
    { }
}
public class C : IBase
{
    public void Method()
    { }
}

No exemplo anterior, renomeando C.Method() também renomeia Ibase.Method() porque C.Method() implementa Ibase.Method(). Em seguida, o refatorar mecanismo recursivamente vê que Ibase.Method() é implementada por Derived.Method() e renomeia Derived.Method(). O mecanismo do refatorar não renomeia Base.Method(), pois Derived.Method() não substitua Base.Method(). O mecanismo de refatoração pára aqui, a menos que você tenha Renomear sobrecargas check-in o Renomear caixa de diálogo.

If Renomear sobrecargas estiver marcada, o mecanismo do refatorar renomeia Derived.Method(int i) porque sobrecarrega Derived.Method(), Base.Method(int i) porque ele é substituído por Derived.Method(int i), e Base.Method() porque é uma sobrecarga Base.Method(int i).

Observação:
Quando você renomeia um membro que foi definido em um assembly referenciado, uma caixa de diálogo explica que a renomeação irá causa erros de compilação.

Renomeando propriedades de tipos anônimo

Quando você renomeia uma propriedade em tipos anônimo, a operação de renomeação propagará às propriedades em outros tipos anônimo que têm as mesmas propriedades.Os exemplos a seguir ilustram esse comportamento.

var a = new { ID = 1};
var b = new { ID = 2};

No código anterior, renomear ID será alterada ID em ambas as instruções porque eles têm o mesmo tipo anônimo subjacente.

var companyIDs =
    from c in companylist
    select new { ID = c.ID, Name = c.Name};

var orderIDs =
    from o in orderlist
    select new { ID = o.ID, Item = o.Name};

No código anterior, renomeando ID só será renomear uma instância do ID porque companyIDs e orderIDs não tem as mesmas propriedades.

Consulte também

Tarefas

Como: Renomear identificadores

Conceitos

Refatoração

Referência

Tipos anônimos (Guia de programação C#)

Outros recursos

Controle de Código Fonte para o Visual Studio