Service Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Regroupe un ensemble d'instances liées de la classe Port, qui sont associées à un service Web XML. Cette classe ne peut pas être héritée.
public ref class Service sealed : System::Web::Services::Description::DocumentableItem
public ref class Service sealed : System::Web::Services::Description::NamedItem
public sealed class Service : System.Web.Services.Description.DocumentableItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class Service : System.Web.Services.Description.NamedItem
type Service = class
inherit DocumentableItem
[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type Service = class
inherit NamedItem
Public NotInheritable Class Service
Inherits DocumentableItem
Public NotInheritable Class Service
Inherits NamedItem
- Héritage
- Héritage
- Attributs
Exemples
#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 = gcnew Port;
myPort->Name = PortName;
myPort->Binding = gcnew XmlQualifiedName( BindingName,targetNamespace );
// Create a SoapAddress extensibility element to add to the port.
SoapAddressBinding^ mySoapAddressBinding = gcnew SoapAddressBinding;
mySoapAddressBinding->Location = "http://localhost/ServiceClass/MathService_CS.asmx";
myPort->Extensions->Add( mySoapAddressBinding );
return myPort;
}
int 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: {0}", noOfServices );
// Gets a reference to the service.
Service^ myOldService = myServiceCollection[ 0 ];
Console::WriteLine( "No. of ports in the service: {0}", 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: {0}", myOldService->Ports[ i ]->Name );
Console::WriteLine( "Service name: {0}", myOldService->Name );
Service^ myService = gcnew 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: {0}", myOldService->Ports[ i ]->Name );
// Add the extensions to the newly created Service.
int noOfExtensions = myOldService->Extensions->Count;
Console::WriteLine( "No. of extensions: {0}", 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: {0}", e->Message );
}
}
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;
}
}
Imports System.Web.Services.Description
Imports System.Xml
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
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
Remarques
La Service
classe correspond à l’élément WSDL (Web Services Description Language) <service>
placé entre l’élément <definitions>
racine. Pour plus d’informations sur WSDL, consultez la spécification WSDL.
Constructeurs
Service() |
Initialise une nouvelle instance de la classe Service. |
Propriétés
Documentation |
Obtient ou définit la documentation pour l'instance de DocumentableItem. (Hérité de DocumentableItem) |
DocumentationElement |
Obtient ou définit l'élément documentation pour DocumentableItem. (Hérité de DocumentableItem) |
ExtensibleAttributes |
Obtient ou définit un tableau de type XmlAttribute qui représente des extensions d'attribut de WSDL pour se conformer au Basic Profile 1.1 du WS-I (Web Services Interoperability). (Hérité de DocumentableItem) |
Extensions |
Obtient la collection d'éléments d'extensibilité associée au Service. |
Name |
Obtient ou définit le nom de l'élément. |
Name |
Obtient ou définit le nom de l'élément. (Hérité de NamedItem) |
Namespaces |
Obtient ou définit le dictionnaire de préfixes d'espace de noms et d'espaces de noms utilisé pour conserver des préfixes d'espace de noms et des espaces de noms lorsqu'un objet ServiceDescription est construit. (Hérité de DocumentableItem) |
Ports |
Obtient la collection des instances Port contenues dans Service. |
ServiceDescription |
Obtient ServiceDescription dont Service est membre. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |