COMO: Utilizar elementos XmlDocument quando transmitidos para ou devolvidas a partir do WebMethods utilizando o Visual C# .NET

• System.XML

Voltar ao topo

IN THIS TASK

• SUMMARY
  • Introduction
    • Create a Web Method
    • Consume the Web Method
  • Troubleshoot
• REFERENCES

Voltar ao topo

Voltar ao topo

Introduction

• XmlDocument.LoadXml(XmlNode.OuterXml)
• XmlDocument.ImportNode(XmlNode, true)

Voltar ao topo

Create a Web Method

1. No Microsoft Visual Studio. NET, crie um novo Visual C# .NET ASP.NET Web Service projecto. Para o fazer, siga estes passos:
   1. No menu ficheiro , clique em Novo e, em seguida, clique em projecto .
   2. Na lista Tipos de projecto , clique em Visual C# Projects e, em seguida, clique em Serviço Web do ASP.NET no painel de modelos .
2. Na caixa de texto localização , escreva XMLDocService para alterar o nome predefinido (o nome predefinido é WebService1).
3. Altere o nome do serviço Web predefinido que é criado a partir do Service1.asmx para XMLDocService.asmx .
4. Clique em clique aqui para mudar para vista de código no ambiente de estruturador para mudar para vista de código.
5. Defina um método que devolve um objecto XMLDocument . Cada método irão expor o serviço tem ser sinalizado com um atributo ' WebMethod . Sem este atributo, o serviço não irão expor o método.
   
   Nota Nem todos os método tem de ter o atributo ' WebMethod . Este atributo pode ser utilizado para ocultar alguns detalhes de implementação que são chamados por métodos do serviço Web públicos ou se a classe WebService é utilizada nas aplicações locais. Embora uma aplicação local pode utilizar qualquer classe pública, apenas WebMethod métodos podem ser acessíveis remotamente como XML Web serviços.
6. Adicione os seguintes métodos de serviço Web à classe XMLDocService que acabou de criar:

   [WebMethod]
   public XmlDocument GetXmlDocument()
   {
   // Create an XmlDocument object.
   XmlDocument xmlDocumentObject = new XmlDocument();
   XmlDocumentObject.LoadXml("<book genre=\"novel\" publicationdate=\"1997\" " +
   "      ISBN=\"1-861001-57-5\">" +
   "  <title>Pride And Prejudice</title>" +
   "  <author>" +
   "    <first-name>Jane</first-name>" +
   "    <last-name>Austen</last-name>" +
   "  </author>" +
   "  <price>24.95</price>" +
   "</book>"); 
   
   // Return the created XmlDocument object.
   return( XmlDocumentObject );
   }

   [WebMethod]
   public string GetFirstName( XmlNode XmlNodePassed )
   {
   // Create a new XmLDocument object.
   XmlDocument XmlDocumentObject = new XmlDocument();
   
   // Load the XmlNode into the XmlDocument object.
   XmlDocumentObject.LoadXml( XmlNodePassed.OuterXml );
   
   // Find the first name of the author.
   XmlNodeList XmlNodeListObj = XmlDocumentObject.GetElementsByTagName( "first-name" );
   
   // Return the first name.
   return XmlNodeListObj[ 0 ].ChildNodes[ 0 ].Value;
   }

7. No menu criar , clique em criar soluções para criar o serviço Web.
8. Abra a página de serviço XMLDocService.asmx XML Web para testar o serviço Web XML. Se definido no computador local para hospedar a página, o URL é http://localhost/XMLDocService/XMLDocService.asmx. O Microsoft ASP.NET runtime devolve a página de ajuda uma XML Web service, que descreve os XML Web service. Também pode utilizar esta página para testar os diferentes métodos de serviço Web XML.

Voltar ao topo

Consume the Web Method

1. No Visual Studio. NET, clique em Novo no menu ficheiro e, em seguida, clique em projecto .
2. Na lista de Tipos de projecto , clique em Visual C# Projects e, em seguida, clique em Aplicação de consola no painel de modelos .
3. Na nova aplicação, adicione uma referência ao serviço Web XMLDocService .
   
   Este passo cria uma classe de proxy no computador cliente. Depois de criada a classe proxy, é possível criar objectos baseiam-se a classe. Cada chamada de método efectuadas com o objecto é transferida para uniform resource identifier (URI) do serviço Web como um pedido SOAP.
   1. No menu projecto , clique em Adicionar referência Web .
   2. Na caixa de diálogo Adicionar referência Web , escreva o URL do serviço Web na caixa de texto endereço e, em seguida, prima ENTER. Se definir o computador local para hospedar o serviço Web, o URL é http://localhost/XMLDocService/XMLDocService.asmx.
   3. Clique em Adicionar referência . Em alternativa, pode escreva o URL do ficheiro de identificação (XMLDocService.vsdisco) ou clicar em Referências de Web num servidor Web Local no painel da esquerda para seleccionar o serviço XMLDocService a partir da lista.
   4. Expanda a secção Referências Web Solution Explorer e anote o espaço de nomes que foi utilizado.
4. Crie uma instância do objecto proxy para o serviço da Web XMLDocService . Cole o seguinte código na função principal :

   localhost.XMLDocService myXMLDocService = new localhost.XmlDocService();

5. Para invocar o método do objecto proxy, utilize o seguinte código:

   XmlDocument myXmlDocumentObject = myXMLDocService.GetXmlDocument();

6. No menu criar , clique em criar soluções para criar a aplicação da consola.
7. Receberá a seguinte mensagem de erro de compilação:
   Não é possível converter implicitamente o tipo System.XML.XmlDocument para 'System.Xml.XmlNode'
8. Substituir a chamada do método com o seguinte:

   XmlNode myXMLNodeObject = myXMLDocService.GetXmlDocument();

9. No menu criar , clique em criar soluções para criar a aplicação da consola. Pode criar com êxito a aplicação.
10. Carregar os dados in a XmlNode devolvidos para um objecto XmlDocument utilizando o método ImportNode :

    XmlDocument myXmlDocumentObject = new XmlDocument();
    myXmlDocumentObject.AppendChild(myXmlDocumentObject.ImportNode(myXMLNodeObject,true));

11. Efectuar uma chamada para o método de serviço Web que devolve o nome do autor:

    string strFirstName = WebServiceObject.GetFirstName( XmlDocumentObject );

12. Imprimir o nome próprio do autor na consola:

    Console.WriteLine( "The first name of the author is: " +strFirstName );

13. No menu criar , clique em criar soluções para criar a aplicação da consola.
14. No menu Debug , clique em Executar para executar a aplicação da consola.

Voltar ao topo

Resolução de problemas

Voltar ao topo