15/10/2008

Usar Code Snippets em C#



Para começar Code Snippets são fragmentos de código pré feitos, muitos dos códigos que utilizamos com regularidade como ciclos de repetição entre outros já vem definidos e prontos a ser utilizados.

Os code snippets podem ser utilizados de 3 maneiras, utilizando as teclas de atalho Crt+K mais Crt+X, acendendo ao menu Edit no tópico IntelliSence e Insert Snippet e por ultimo através do 3 botão do rato seleccionando a opção Insert Snippet.

Alem dos códigos definidos o utilizador tem a possibilidade de criar os seus próprio fragmentos de código e aconselho mesmo se utilizar uma determinado código constantemente a defini-lo evitando estar a fazer copy e paste constantemente.

Agora vamos ao que mais interessa que é como criar estes fragmentos de código, para começar devemos criar um ficheiro XML e obedecer a determinados regras tais como:

Deve começar sempre com:

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">


De seguida é introduzido um pequeno cabeçalho onde indica o titulo do fragmento de código bem como outras informações como o Author , Description .

<Header>
<Title>
My Output Writer
</Title>
<Author>
JPontes
</ Author>
<Description>
Escreve na consola
</Description>
</Header>


Neste momento vamos propriamente escrever o fragmento de código começando por indicar qual a linguagem que será inserido e o código a inserir :
Para a linguagem C# as referencias não são incluídas no xml sendo que estão devem ser incluídas manualmente, para o restos das linguagens pode acrescentar a entidade Reference para indicar as suas dependências.

<Snippet>
<Code Language=" CSharp ">
<![CDATA[Console.WriteLine("Texto");]]>
</Code>
</Snippet>
O ficheiro final CodeSnippetWriteOutput.snippet:

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>My Output Writer </Title>
<Author>JPontes</Author>
<Description>Escreve na consola</Description>
</Header>
<Snippet>
<Code Language="CSharp">
<![CDATA[Console.WriteLine("Texto aqui");]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>

Agora basta importar o code snipped através do Code Sinpped Manager para poder utilizar nas suas aplicações.














E utilizar :

Referencias:

Sem comentários: