Aprenda a criar parâmetros opcionais e nomeados - Revista easy .net Magazine 24

O artigo explica e demonstra na prática o que são os parâmetros opcionais e nomeados no C# 4.0. Este recurso permite que sejam criados métodos com parâmetros flexíveis, trazendo mais reusabilidade na hora de invocá-los.

De que se trata o artigo

Este artigo apresenta os primeiros passos usando o C# para fazer a leitura e a criação de documentos XML. Através de classes próprias do C# (tal como a XmlReader), será possível manipular por completo esses tipos de documentos.

Em que situação o tema é útil

O tema é útil quando for necessário criar uma forma padronizada de transportar dados (em formato de texto) de uma aplicação para outra. Através do XML será possível criar arquivos com padrões pré-definidos, servindo até mesmo para salvar pequenas informações, como logs de registros, configurações da sua aplicação etc. Um exemplo bastante comum é o uso da Nota Fiscal Eletrônica, que utiliza XML como padrão para a transmissão de dados.

Primeiros passos com documentos XML - Manipulando documentos XML no C#

O XML é composto, basicamente, por texto puro. Seus elementos lembram muito outra linguagem: o HTML, porém, possuindo regras distintas (que serão vistas no decorrer do artigo) para formação dos documentos. Sua manipulação dentro dos programas é uma tarefa mais complexa, principalmente por causa da hierarquia dos seus elementos e das regras para que estes documentos sejam bem formados. O Framework .NET e a linguagem C# facilitam muito o trabalho com os arquivos XML, já que disponibiliza uma estrutura completa para o uso do mesmo. Assim, neste artigo será desenvolvido um pequeno aplicativo que irá servir de base para a manipulação de documentos XML (tanto para leitura e escrita).

No final da década de 1990 a Internet começou a consolidar-se como plataforma para aplicações mais robustas, como aquelas voltadas para o ambiente coorporativo. Logo, surgiu a necessidade de definir uma forma de facilmente fazer a troca de dados entre estas aplicações, o que apontou um problema: naquela época o ambiente e as linguagens usadas para criação destas aplicações não era homogêneo, o que dificultava ainda mais a integração.

Além disso, havia a questão da segurança, uma vez que alguns firewalls barravam certos protocolos e tipos de dados (como ainda fazem), era preciso que os dados pudessem resolver este problema sem expor a segurança.

Por causa destes e de outros pontos, foi definida a linguagem XML – eXtensible Markup Language – para a criação dos documentos, que tem como principal vantagem serem formados por texto puro, o que garante livre passagem pelos Firewalls usando o protocolo HTTP, sem comprometer a segurança.

As principais características dos documentos XML podem ser enumeradas da seguinte forma:

1. Conteúdo definido através de TAGS da mesma forma que os documentos HTML, apenas com a consideração de que para cada TAG aberta, outra de fechamento deve ser definida. Assim, se no documento existir uma TAG <cliente> aberta para armazenar o conteúdo, uma tag </cliente> de fechamento deve ser informada ao final do mesmo. Também é possível ter um elemento vazio usando a TAG <cliente /> (da mesma forma que na linguagem HTML).

2. O documento é criado de forma hierárquica. É possível ter vários elementos – que são chamados tecnicamente de nós – aninhados, o que possibilita a expressão de tipos de dados complexos usando esta linguagem.

3. Os documentos XML podem seguir uma estrutura pré-definida de maneira que o seu conteúdo possa ser validado. Esta estrutura é chamada de schema (XML Schemas) e existem ferramentas no Framework .NET para a comparação dos documentos com os schemas. Os arquivos de schema possuem a extensão XSD.

4. Por causa de sua flexibilidade e suas facilidades, com a linguagem XML e os documentos que são geradas usando-a, outras aplicações podem ser criadas. Com esta linguagem podem ser criados documentos para armazenamento de configurações de documentos, arquivos para compor a interface de aplicações, tal qual é feito com a linguagem XML e assim por diante.

Existem muitas características dessa linguagem, vejamos antes de continuar um típico documento XML com os elementos mais simples. A Listagem 1 mostra um documento XML bem simples.

Listagem 1. Exemplo de documento XML

<?xml version="1.0" encoding="utf-8"?> <config> <software_name>XmlGrid</software_name> <software_category>Windows Application</software_category> <platform>.Net Framework v. 4.0</platform> <author>Vladimir Rech</author> <date>09/06/2012</date> </config>

Observe que para cada TAG de abertura existe uma fechando. Note também que existe um nível principal representado pela TAG <config>, assim, os demais nós estão aninhados, sendo que <config> representa o nó principal do documento.

As regras para formar corretamente um documento XML são bem simples:

• Para cada TAG de abertura deve haver uma fechando ou, se estiver vazia, deve aparecer na forma <config />, por exemplo.

• A linguagem XML é case sensitive, ou seja, as TAGS diferenciam maiúsculas de minúsculas.

• Não são permitidos espaços nas TAGS. Note que na TAG <software_name> foi usado o caractere underscore “_” para poder compor um nome mais significativo.

• O documento XML dá suporte para uso de páginas de código para suportar diferentes tipos de caractere. Note no documento de exemplo que na primeira linha está sendo definido o tipo de codificação que será usado no atributo “encoding=’utf-8’”. A definição de qual codificação utilizar garante que caracteres especiais possam ser utilizados (como os acentos da língua portuguesa) nos documentos XML.

Este documento tem outra característica importante, que é possuir apenas um nível. Todos os elementos estão aninhados na TAG <config>. É possível definir vários níveis de elementos no documento XML. Observe o arquivo da Listagem 2.

[Listagem 2. Documento XML com vários níveis

1 <?xml version="1.0"?> 2 <PedidoDeVenda xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 4 Empresa="2" 5 xmlns="http://www.contoso.org"> 6 <ID>9</ID> 7 <Data>2010-01-26T00:00:00</Data> 8 <Cliente ID="999"> 9 <Nome>Supermercados Fartura Ltda</Nome> 10 <Telefone>41-9419-0987</Telefone> 11 <Cidade>Curitiba</Cidade> 12 <Estado>Paraná</Estado> 13 <EMail>comercial@sfartura.com.br</EMail> 14 </Cliente> 15 <Valor>2034</Valor> 16 <Desconto>34</Desconto> 17 <Itens> 18 <PedidoItens> 19 <CodigoProduto>7</CodigoProduto> 20 <DescricaoProduto>Castanha do Para</DescricaoProduto> 21 <Quantidade>100</Quantidade> 22 <Unitario>3.33</Unitario> 23 </PedidoItens> 24 <PedidoItens> 25 <CodigoProduto>328</CodigoProduto> 26 <DescricaoProduto>Frutas cristalizadas Feliz Natal</DescricaoProduto> 27 <Quantidade>300</Quantidade> 28 <Unitario>5.67</Unitario> 29 </PedidoItens> 30 </Itens> 31 </PedidoDeVenda>" [...] continue lendo...

Artigos relacionados