Criar e configurar membros de tipo no Designer de Classe
É possível adicionar esses membros aos tipos em um diagrama de classe e configurá-los na Janela Detalhes da Classe:
Tipo | Membros que pode conter |
---|---|
Classe | método, propriedade (para C# e Visual Basic), campo, evento (para C# e Visual Basic), construtor (método), destruidor (método), constante |
Enumeração | member |
Interface | método, propriedade, evento (para C# e Visual Basic) |
Classe Abstrata | método, propriedade (para C# e Visual Basic), campo, evento (para C# e Visual Basic), construtor (método), destruidor (método), constante |
Estrutura (Struct no C#) | método, propriedade (para C# e Visual Basic), campo, evento (para C# e Visual Basic), construtor (método), constante |
Delegar | parâmetro |
Módulo (apenas VB) | método, propriedade, campo, evento, construtor, constante |
Observação
Torne a declaração de propriedade mais concisa quando os acessadores get e set de uma propriedade não precisarem de lógica adicional usando propriedades autoimplementadas (apenas C#). Para mostrar a assinatura completa, no menu Diagrama de Classe, escolha Alterar Formato dos Membros>Exibir Assinatura Completa. Para obter mais informações sobre propriedades autoimplementadas, consulte Propriedades Autoimplementadas.
Tarefas comuns
Tarefa | Conteúdo de suporte |
---|---|
Introdução: antes de criar e configurar membros de tipo, você precisa abrir a janela Detalhes da Classe. | - Abrir a janela Detalhes da Classe - Observações sobre uso de detalhes da classe - Exibição de informações somente leitura - Atalhos de teclado e do mouse no Diagrama de Classe e na janela Detalhes da Classe |
Criar e modificar membros de tipo: você pode criar membros, modificar membros e adicionar parâmetros a um método usando a janela Detalhes da Classe. | - Criar membros - Modificar membros de tipo - Adicionar parâmetros a métodos |
Abra a janela Detalhes da Classe
Por padrão, a janela Detalhes da Classe é exibida automaticamente quando você abre um novo diagrama de classe. Confira Adicionar diagramas de classe a projetos). Também é possível abrir a janela Detalhes da Classe destas maneiras:
Clique com o botão direito do mouse em qualquer classe no diagrama para exibir um menu de contexto. Depois, selecione Detalhes da Classe.
Clique em Exibição>Outras Janelas>Detalhes da Classe na barra de menus.
Criar membros
Você pode criar um membro usando qualquer uma das ferramentas a seguir:
Designer de Classe
Barra de ferramentas da janela Detalhes da Classe
Janela Detalhes da Classe
Observação
Você também pode criar construtores e destruidores usando os procedimentos desta seção. Lembre-se de que construtores e destruidores são tipos especiais de método e, portanto, eles aparecem no compartimento Métodos nas formas do diagrama de classe e na seção Métodos da grade da janela Detalhes da Classe.
Observação
A única entidade que você pode adicionar a um representante é o parâmetro. Observe que o procedimento denominado ‘Criar um membro usando a barra de ferramentas da janela Detalhes da Classe’ não é válido para essa ação.
Criar um membro usando o Designer de Classe
Clique com o botão direito do mouse no tipo ao qual deseja adicionar um membro, aponte para Adicionar e escolha o tipo de membro que deseja adicionar.
Uma nova assinatura de membro é criada e adicionada ao tipo. Ela recebe um nome padrão que pode ser alterado no Designer de Classe, na Janela Detalhes da Classe ou na janela Propriedades.
Se preferir, especifique outros detalhes sobre o membro, como seu tipo.
Criar um membro usando a barra de ferramentas da janela Detalhes da Classe
Na superfície de diagrama, selecione o tipo ao qual deseja adicionar um membro.
O tipo obtém foco e seu conteúdo é exibido na janela Detalhes da Classe.
Na barra de ferramentas da janela Detalhes da classe, clique no ícone superior e selecione Novo <membro> na lista suspensa.
O cursor é movido para o campo Nome em uma linha para o tipo de membro que você deseja adicionar. Por exemplo, se você tiver clicado em Nova Propriedade, o cursor passará para uma nova linha na seção Propriedades da janela Detalhes da Classe.
Digite o nome do membro que deseja criar e pressione Enter (ou, de outra forma, mova o foco, pressionando Tab).
Uma nova assinatura de membro é criada e adicionada ao tipo. Agora, o membro existe no código e é exibido no Designer de Classe, na janela Detalhes da Classe e na janela Propriedades.
Se preferir, especifique outros detalhes sobre o membro, como seu tipo.
Criar um membro usando a janela Detalhes da Classe
Na superfície de diagrama, selecione o tipo ao qual deseja adicionar um membro.
O tipo obtém foco e seu conteúdo é exibido na janela Detalhes da Classe.
Na janela Detalhes da classe, na seção que contém o tipo de membro que você deseja adicionar, clique em <Adicionar membro>. Por exemplo, se quiser adicionar um campo, clique em <Adicionar campo>.
Digite o nome do membro que deseja criar e pressione Enter.
Uma nova assinatura de membro é criada e adicionada ao tipo. Agora, o membro existe no código e é exibido no Designer de Classe, na janela Detalhes da Classe e na janela Propriedades.
Se preferir, especifique outros detalhes sobre o membro, como seu tipo.
Observação
Use também atalhos de teclado para criar membros. Para obter mais informações, confira Atalhos de teclado e do mouse no Diagrama de Classe e na janela Detalhes da Classe.
Modificar membros de tipo
O Designer de Classe permite modificar os membros dos tipos que são exibidos no diagrama. É possível modificar os membros de qualquer tipo exibido em um diagrama de classes que não sejam somente leitura. Modifique os membros de tipo usando a edição in-loco na superfície de design, na janela Propriedades e na janela Detalhes da Classe.
Todos os membros exibidos na janela Detalhes da Classe representam os membros dos tipos no diagrama de classe. Há quatro tipos de membro: métodos, propriedades, campos e eventos.
Todas as linhas de membro aparecem abaixo dos cabeçalhos que agrupam os membros por tipo. Por exemplo, todas as propriedades aparecem abaixo do cabeçalho Propriedades que, como um nó na grade, pode ser recolhido ou expandido.
Cada linha de membro exibe os seguintes elementos:
Ícone do membro
Cada tipo de membro é representado por seu próprio ícone. Aponte o mouse para o ícone do membro para exibir a assinatura do membro. Clique no ícone do membro ou no espaço em branco à esquerda do ícone do membro para selecionar a linha.
Nome do membro
A coluna Nome em uma linha de membro exibe o nome do membro. Esse nome também é exibido na propriedade Nome na janela Propriedades. Use essa célula para alterar o nome de qualquer membro que tenha permissões de leitura/gravação.
Se a coluna Nome for muito estreita para mostrar o nome inteiro, apontar o mouse para o nome do membro exibe o nome inteiro.
Tipo do membro
A célula MemberType usa o IntelliSense, que permite fazer seleções em uma lista de todos os tipos disponíveis no projeto atual ou em projetos referenciados.
Modificador do membro
Altere o modificador de visibilidade de um membro para
Public
(public
),Private
(private
),Friend
(internal
)Protected
(protected
),Protected Friend
(protected internal
) ouDefault
.<Adicionar membro>
A última linha na janela Detalhes da classe contém o texto <Adicionar membro> na célula Nome. Se você clicar nessa célula, será possível criar um novo membro. Para obter mais informações, consulte Criar membros.
Propriedades do membro na janela Propriedades
A janela Detalhes da Classe exibe um subconjunto das propriedades do membro que são exibidas na janela Propriedades. Alterar uma propriedade em um local atualizará o valor da propriedade globalmente. Isso inclui a exibição de seu valor em outro local.
Resumo
A célula Resumo expõe um resumo das informações sobre o membro. Clique nas reticências na célula Resumo para exibir ou editar informações sobre o Resumo, o Tipo de Retorno e os Comentários do membro.
Ocultar
Quando a caixa de seleção Ocultar é marcada, o membro não é exibido no tipo.
Para modificar um membro de tipo
Usando o Designer de Classe, selecione um tipo.
Se a janela Detalhes da Classe não for exibida, clique no botão da janela Detalhes da Classe na barra de ferramentas do Designer de Classe.
Edite os valores nos campos da grade da janela Detalhes da Classe. Após cada edição, pressione ENTER ou, caso contrário, mova o foco para longe do campo editado, por exemplo, pressionando TAB. Suas edições são refletidas imediatamente no código.
Observação
Se desejar modificar apenas o nome de um membro, você poderá fazer isso usando a edição in-loco.
Adicionar parâmetros a métodos
Adicione parâmetros aos métodos usando a janela Detalhes da Classe. Os parâmetros podem ser configurados para serem obrigatórios ou opcionais. Fornecer um valor para a propriedade Padrão Opcional de um parâmetro instrui o designer a gerar código como um parâmetro opcional.
As linhas de parâmetro contém os seguintes itens:
Nome
A coluna Nome em uma linha de parâmetro exibe o nome do parâmetro. Esse nome também é exibido na propriedade Nome na janela Propriedades. Você pode usar essa célula para alterar o nome de qualquer parâmetro com permissões de leitura/gravação.
Apontar para o nome do parâmetro exibe o nome do parâmetro se a coluna Nome for muito estreita para mostrar o nome inteiro.
Tipo
A célula Tipo de Parâmetro usa o IntelliSense, o que lhe permite fazer escolhas em uma lista com todos os tipos disponíveis no projeto atual ou nos projetos referenciados.
Modificador
A célula Modificador em uma linha de parâmetro aceita e exibe o novo modificador do parâmetro. Para inserir um novo modificador de parâmetro, use a caixa de listagem suspensa para selecionar Nenhum, ref, out ou params no C# e ByVal, ByRef ou ParamArray no VB.
Resumo
A célula Resumo em uma linha de parâmetro permite inserir comentários de código que aparecem no IntelliSense ao inserir o parâmetro no editor de código.
<Adicionar parâmetro>
A última linha de parâmetro de um membro contém o texto <Adicionar parâmetro> na célula Nome. Clicar nessa célula permite criar um novo parâmetro. Para obter mais informações, consulte Para adicionar um parâmetro a um método.
A janela Propriedades exibe as mesmas propriedades de parâmetro exibidas na janela Detalhes da Classe: Nome, Tipo, Modificador, Resumo e também a propriedade Padrão Opcional. Alterar uma propriedade em um local atualiza o valor da propriedade globalmente, incluindo a exibição de seu valor em outro local.
Observação
Para adicionar um parâmetro a um representante, consulte Criar membros.
Observação
Embora um destruidor seja um método, ele não pode ter parâmetros.
Para adicionar um parâmetro a um método
Na superfície de diagrama, clique no tipo que contém o método ao qual deseja adicionar um parâmetro.
O tipo obtém foco e seu conteúdo é exibido na janela Detalhes da Classe.
Na janela Detalhes da Classe, expanda a linha do método ao qual deseja adicionar um parâmetro.
Uma linha de parâmetro recuada é exibida, contendo apenas um par de parênteses e as palavras <adicionar parâmetro>.
Clique em <Adicionar parâmetro>, digite o nome do novo parâmetro e pressione Enter.
O novo parâmetro é adicionado ao método e ao código do método. Ele é exibido na janela Detalhes da Classe e na janela Propriedades.
Se preferir, especifique outros detalhes sobre o parâmetro, como seu tipo.
Para adicionar um parâmetro opcional a um método
Na superfície de diagrama, clique no tipo que contém o método ao qual deseja adicionar um parâmetro opcional.
O tipo obtém foco e seu conteúdo é exibido na janela Detalhes da Classe.
Na janela Detalhes da Classe, expanda a linha do método ao qual deseja adicionar um parâmetro opcional.
Uma linha de parâmetro recuada é exibida, contendo apenas um par de parênteses e as palavras <adicionar parâmetro>.
Clique em <Adicionar parâmetro>, digite o nome do novo parâmetro e pressione Enter.
O novo parâmetro é adicionado ao método e ao código do método. Ele é exibido na janela Detalhes da Classe e na janela Propriedades.
Na janela Propriedades, digite um valor para a propriedade Padrão Opcional. Definir a propriedade Padrão Opcional de um parâmetro o torna opcional.
Observação
Os parâmetros opcionais devem ser os últimos parâmetros na lista de parâmetros.
Observações sobre uso de detalhes da classe
Observe as seguintes dicas para usar a janela Detalhes da Classe.
Células editáveis e não editáveis
Todas as células na janela Detalhes da Classe são editáveis, com algumas exceções:
O tipo inteiro é somente leitura, quando, por exemplo, ele reside em um assembly referenciado. Quando você seleciona a forma no Designer de Classe, a janela Detalhes da Classe exibe seus detalhes em um estado somente leitura.
Para indexadores, o nome é somente leitura e o restante (tipo, modificador, resumo) é editável.
Todos os genéricos têm parâmetros somente leitura na janela Detalhes da Classe. Para alterar um parâmetro genérico, edite seu código-fonte.
O nome do parâmetro de tipo que é definido em um tipo genérico é somente leitura.
Quando o código de um tipo está quebrado (não analisável), a janela Detalhes da Classe exibe o conteúdo do tipo como somente leitura.
A janela Detalhes da Classe e o código-fonte
Você pode exibir o código-fonte clicando com o botão direito do mouse em uma forma na janela Detalhes da Classe (ou no Designer de Classe) e clicando em Exibir Código. O arquivo do código-fonte é aberto e rola até o elemento selecionado.
A alteração do código-fonte é refletida imediatamente na exibição das informações de assinatura no Designer de Classe e na janela Detalhes da Classe. Se a janela Detalhes da Classe estiver fechada no momento, as novas informações ficarão visíveis na próxima vez em que ela for aberta.
Quando o código de um tipo está quebrado (não analisável), a janela Detalhes da Classe exibe o conteúdo do tipo como somente leitura.
Funcionalidade de área de transferência na janela Detalhes da Classe
Você pode copiar ou recortar campos ou linhas da janela Detalhes da Classe e colá-los em outro tipo. Uma linha poderá ser recortada se não for somente leitura. Quando você cola a linha, a janela Detalhes da Classe atribui um novo nome (derivado do nome da linha copiada) para evitar um conflito.
Exibir informações somente leitura
O Designer de Classe e a janela Detalhes da Classe podem exibir os tipos (e membros do tipo) para o seguinte:
um projeto que contém um diagrama de classes
um projeto referenciado de um projeto que contém um diagrama de classes
um assembly referenciado de um projeto que contém um diagrama de classes
Nos dois últimos casos, a entidade referenciada (um tipo ou um membro) é somente leitura no diagrama de classes que a representa.
Um projeto inteiro ou partes dele, como arquivos individuais, podem ser somente leitura. Os casos mais comuns em que um projeto ou um de seus arquivos é somente leitura são quando ele está sob controle do código-fonte (e não foi verificado), ele existe em um assembly externo ou quando o sistema operacional considera os arquivos como sendo somente leitura.
Controle do código-fonte
Como um diagrama de classe é salvo como um arquivo em um projeto, você precisa fazer check-out do projeto para salvar todas as alterações feitas no Designer de Classe ou na janela Detalhes da Classe.
Projetos somente leitura
O projeto pode ser somente leitura por um motivo que não seja o controle de código-fonte. Ao fechar o projeto, uma caixa de diálogo é exibida, perguntando se você deseja substituir o arquivo de projeto, descartar as alterações (não salvar) ou cancelar a operação de fechamento. Se você optar por substituir, os arquivos de projeto serão substituídos e transformados em leitura/gravação. O novo arquivo de diagrama de classes é adicionado.
Tipos somente leitura
Se você tentar salvar um projeto que contém um tipo cujo arquivo do código-fonte seja somente leitura, a caixa de diálogo Salvamento de Arquivo Somente Leitura será exibida, fornecendo opções de salvar o arquivo com um novo nome ou em um novo local, ou de substituir o arquivo somente leitura. Se você substituir o arquivo, a nova cópia não será mais somente leitura.
Se um arquivo de código contiver um erro de sintaxe, as formas que exibem o código nesse arquivo serão somente leitura temporariamente até que o erro de sintaxe seja corrigido. As formas nesse estado exibem texto em vermelho e um ícone vermelho que exibe uma dica de ferramenta onde se lê "O arquivo do código-fonte contém um erro de análise".
Um tipo referenciado (como um tipo .NET), que existe sob outro nó do projeto ou sob um nó de assembly referenciado, é indicado na área de design do Designer de Classe como somente leitura. Um tipo local, que existe no projeto que você abriu, é leitura/gravação e sua forma na superfície de design de Designer de Classe é indicada como tal.
Os indexadores são de leitura/gravação no código e na janela Detalhes da Classe, mas o nome do indexador é somente leitura.
Não é possível editar métodos parciais usando o Designer de Classe ou a janela Detalhes da Classe. Use o Editor de Códigos para editá-los.
Não é possível editar código C++ nativo usando o Designer de Classe ou a janela Detalhes da Classe. Use o Editor de Códigos para editar código C++ nativo.