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
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)