This documentation is archived and is not being maintained.

Service Class

Groups together a set of related instances of the Port class that are associated with an XML Web service. This class cannot be inherited.

For a list of all members of this type, see Service Members.

System.Object
   System.Web.Services.Description.DocumentableItem
      System.Web.Services.Description.Service

[Visual Basic]
NotInheritable Public Class Service
   Inherits DocumentableItem
[C#]
public sealed class Service : DocumentableItem
[C++]
public __gc __sealed class Service : public DocumentableItem
[JScript]
public class Service extends DocumentableItem

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

The Service class corresponds to the Web Services Description Language (WSDL) <service> element enclosed by the <definitions> root element. For more information about WSDL, see the specification at http://www.w3.org/TR/wsdl/.

Example

[Visual Basic] 
Imports System
Imports System.Web.Services.Description
Imports System.Xml
Imports Microsoft.VisualBasic

Class MyServiceClass
   Public Shared Sub Main()
      Try
         ' Read a WSDL document.
         Dim myServiceDescription As ServiceDescription = _
            ServiceDescription.Read("MathService_vb.wsdl")
         Dim myServiceCollection As ServiceCollection = _
            myServiceDescription.Services

         Dim noOfServices As Integer = myServiceCollection.Count
         Console.WriteLine(ControlChars.Newline & _
            "Total Number of Services :" & noOfServices.ToString())

         ' Gets a reference to the service.
         Dim myOldService As Service = myServiceCollection(0)
         Console.WriteLine("No. of Ports in the Service" & _
            myServiceCollection(0).Ports.Count.ToString())
         Console.WriteLine("These are the ports in the service:")
         Dim i As Integer
         For i = 0 To myOldService.Ports.Count - 1
            Console.WriteLine("Port name: " & myOldService.Ports(i).Name)
         Next i
         Console.WriteLine("Service name: " & myOldService.Name)

         Dim myService As New Service()
         myService.Name = "MathService"

         ' Add the Ports to the newly created Service.
         Dim j As Integer
         For j = 0 To myOldService.Ports.Count - 1
            Dim PortName As String = myServiceCollection(0).Ports(j).Name
            Dim BindingName As String = _
               myServiceCollection(0).Ports(j).Binding.Name
            myService.Ports.Add(CreatePort(PortName, BindingName, _
               myServiceDescription.TargetNamespace))
         Next j

         Console.WriteLine("Newly created ports -")
         Dim k As Integer
         For k = 0 To myService.Ports.Count - 1
            Console.WriteLine("Port name: " & myOldService.Ports(k).Name)
         Next k 

         ' Add the extensions to the newly created Service.
         Dim noOfExtensions As Integer = myOldService.Extensions.Count
         Console.WriteLine("No. of extensions: " & noOfExtensions.ToString())
         If noOfExtensions > 0 Then
            Dim l As Integer
            For l = 0 To myOldService.Ports.Count - 1
               myService.Extensions.Add(myServiceCollection(0).Extensions(l))
            Next l
         End If 

         ' Remove the service from the collection.
         myServiceCollection.Remove(myOldService)

         ' Add the newly created service.
         myServiceCollection.Add(myService)
         
         myServiceDescription.Write("MathService_New.wsdl")
      Catch e As Exception
         Console.WriteLine("Exception:" & e.Message)
      End Try
   End Sub 'Main

   Public Shared Function CreatePort(PortName As String, _
          BindingName As String, targetNamespace As String) As Port
      Dim myPort As New Port()
      myPort.Name = PortName
      myPort.Binding = New XmlQualifiedName(BindingName, targetNamespace)

      ' Create a SoapAddress extensibility element to add to the port.
      Dim mySoapAddressBinding As New SoapAddressBinding()
      mySoapAddressBinding.Location = _
         "http://localhost/ServiceClass/MathService.vb.asmx"
      myPort.Extensions.Add(mySoapAddressBinding)
      Return myPort
   End Function 'CreatePort
End Class 'MyServiceClass

[C#] 
using System;
using System.Web.Services.Description;
using System.Xml;

class MyServiceClass
{
   public static void Main()
   {
      try
      {
         // Read a WSDL document.
         ServiceDescription myServiceDescription = 
            ServiceDescription.Read("MathService_CS.wsdl");
         ServiceCollection myServiceCollection = 
            myServiceDescription.Services;

         int noOfServices = myServiceCollection.Count;
         Console.WriteLine("\nTotal number of services: " + noOfServices);
         
         // Gets a reference to the service.
         Service  myOldService = myServiceCollection[0];
         Console.WriteLine("No. of ports in the service: "+
            myServiceCollection[0].Ports.Count);
         Console.WriteLine("These are the ports in the service:");
         for(int i = 0 ; i < myOldService.Ports.Count; i++)
            Console.WriteLine("Port name: " + myOldService.Ports[i].Name);
         Console.WriteLine("Service name: " + myOldService.Name);

         Service myService = new Service();
         myService.Name = "MathService";
         
         // Add the Ports to the newly created Service.
         for(int i = 0; i < myOldService.Ports.Count; i++)
         {
            string PortName = myServiceCollection[0].Ports[i].Name;
            string BindingName = myServiceCollection[0].Ports[i].Binding.Name;
            myService.Ports.Add(CreatePort(PortName,BindingName,
               myServiceDescription.TargetNamespace));
         }

         Console.WriteLine("Newly created ports -");
         for(int i = 0; i < myService.Ports.Count; i++)
            Console.WriteLine("Port name: " + myOldService.Ports[i].Name);

         // Add the extensions to the newly created Service.
         int noOfExtensions = myOldService.Extensions.Count;
         Console.WriteLine("No. of extensions: " + noOfExtensions);
         if (noOfExtensions > 0)
         {
            for(int i = 0; i < myOldService.Ports.Count; i++)
               myService.Extensions.Add(myServiceCollection[0].Extensions[i]);
         }

         // Remove the service from the collection.
         myServiceCollection.Remove(myOldService);
         
         // Add the newly created service.
         myServiceCollection.Add(myService);
         
         myServiceDescription.Write("MathService_New.wsdl");
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception: " + e.Message);
      }
   }

   public static Port CreatePort(string PortName,string BindingName,
      string targetNamespace)
   {
      Port myPort = new Port();
      myPort.Name = PortName;
      myPort.Binding = new XmlQualifiedName(BindingName,targetNamespace);

      // Create a SoapAddress extensibility element to add to the port.
      SoapAddressBinding mySoapAddressBinding = new SoapAddressBinding();
      mySoapAddressBinding.Location = 
         "http://localhost/ServiceClass/MathService_CS.asmx";
      myPort.Extensions.Add(mySoapAddressBinding);
      return myPort;
   }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
#using <System.Web.Services.dll>
#using <System.dll>
using namespace System;
using namespace System::Web::Services::Description;
using namespace System::Xml;

Port* CreatePort(String* PortName,String* BindingName,
                 String* targetNamespace)
{
   Port* myPort = new Port();
   myPort->Name = PortName;
   myPort->Binding = new XmlQualifiedName(BindingName,targetNamespace);

   // Create a SoapAddress extensibility element to add to the port.
   SoapAddressBinding* mySoapAddressBinding = new SoapAddressBinding();
   mySoapAddressBinding->Location =
      S"http://localhost/ServiceClass/MathService_CS.asmx";
   myPort->Extensions->Add(mySoapAddressBinding);
   return myPort;
}

int main()
{
   try
   {
      // Read a WSDL document.
      ServiceDescription* myServiceDescription =
         ServiceDescription::Read(S"MathService_CS.wsdl");
      ServiceCollection* myServiceCollection =
         myServiceDescription->Services;

      int noOfServices = myServiceCollection->Count;
      Console::WriteLine(S"\nTotal number of services: {0}", __box(noOfServices));

      // Gets a reference to the service.
      Service*  myOldService = myServiceCollection->Item[0];
      Console::WriteLine(S"No. of ports in the service: {0}",
         __box(myServiceCollection->Item[0]->Ports->Count));
      Console::WriteLine(S"These are the ports in the service:");
      for(int i = 0 ; i < myOldService->Ports->Count; i++)
         Console::WriteLine(S"Port name: {0}", myOldService->Ports->Item[i]->Name);
      Console::WriteLine(S"Service name: {0}", myOldService->Name);

      Service* myService = new Service();
      myService->Name = S"MathService";

      // Add the Ports to the newly created Service.
      for(int i = 0; i < myOldService->Ports->Count; i++)
      {
         String* PortName = myServiceCollection->Item[0]->Ports->Item[i]->Name;
         String* BindingName = myServiceCollection->Item[0]->Ports->Item[i]->Binding->Name;
         myService->Ports->Add(CreatePort(PortName,BindingName,
            myServiceDescription->TargetNamespace));
      }

      Console::WriteLine(S"Newly created ports -");
      for(int i = 0; i < myService->Ports->Count; i++)
         Console::WriteLine(S"Port name: {0}", myOldService->Ports->Item[i]->Name);

      // Add the extensions to the newly created Service.
      int noOfExtensions = myOldService->Extensions->Count;
      Console::WriteLine(S"No. of extensions: {0}", __box(noOfExtensions));
      if (noOfExtensions > 0)
      {
         for(int i = 0; i < myOldService->Ports->Count; i++)
            myService->Extensions->Add(myServiceCollection->Item[0]->Extensions->Item[i]);
      }

      // Remove the service from the collection.
      myServiceCollection->Remove(myOldService);

      // Add the newly created service.
      myServiceCollection->Add(myService);

      myServiceDescription->Write(S"MathService_New.wsdl");
   }
   catch(Exception* e)
   {
      Console::WriteLine(S"Exception: {0}", e->Message);
   }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Web.Services.Description

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Web.Services (in System.Web.Services.dll)

See Also

Service Members | System.Web.Services.Description Namespace

Show: