ContractReference Classe

Référence

Définition

Espace de noms:: System.Web.Services.Discovery

Assembly:: System.Web.Services.dll

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.

Représente une référence à une description de service dans un document de découverte.

public ref class ContractReference : System::Web::Services::Discovery::DiscoveryReference

public class ContractReference : System.Web.Services.Discovery.DiscoveryReference

type ContractReference = class
    inherit DiscoveryReference

Public Class ContractReference
Inherits DiscoveryReference

Héritage: Object

DiscoveryReference
ContractReference

Exemples

#using <System.Xml.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Xml;
using namespace System::IO;
using namespace System::Web::Services::Discovery;
int main()
{
   try
   {
      
      // Get a DiscoveryDocument.
      DiscoveryDocument^ myDiscoveryDocument = gcnew DiscoveryDocument;
      
      // Get a ContractReference.
      ContractReference^ myContractReference = gcnew ContractReference;
      
      // Set the URL to the referenced service description.
      myContractReference->Ref = "http://localhost/service1.asmx?wsdl";
      
      // Set the URL for an XML Web service implementing the service
      // description.
      myContractReference->DocRef = "http://localhost/service1.asmx";
      SoapBinding^ myBinding = gcnew SoapBinding;
      myBinding->Binding = gcnew XmlQualifiedName( "q1:Service1Soap" );
      myBinding->Address = "http://localhost/service1.asmx";
      
      // Add myContractReference to the list of references contained
      // in the discovery document.
      myDiscoveryDocument->References->Add( myContractReference );
      
      // Add Binding to the references collection.
      myDiscoveryDocument->References->Add( myBinding );
      
      // Open or create a file for writing.
      FileStream^ myFileStream = gcnew FileStream( "Service1.disco",FileMode::OpenOrCreate,FileAccess::Write );
      StreamWriter^ myStreamWriter = gcnew StreamWriter( myFileStream );
      
      // Write myDiscoveryDocument into the passed stream.
      myDiscoveryDocument->Write( myStreamWriter );
      Console::WriteLine( "The Service1.disco is generated." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error is {0}", e->Message );
   }

}

using System;
using System.Xml;
using System.IO;
using System.Web.Services.Discovery;

public class MyContractReference
{
   static void Main()
   {
      try
      {
         // Get a DiscoveryDocument.
         DiscoveryDocument myDiscoveryDocument = new  DiscoveryDocument();

         // Get a ContractReference.
         ContractReference myContractReference = new ContractReference();

         // Set the URL to the referenced service description.
         myContractReference.Ref = "http://localhost/service1.asmx?wsdl";

         // Set the URL for an XML Web service implementing the service
         // description.
         myContractReference.DocRef = "http://localhost/service1.asmx";
         SoapBinding myBinding = new SoapBinding();
         myBinding.Binding = new XmlQualifiedName("q1:Service1Soap");
         myBinding.Address = "http://localhost/service1.asmx";

         // Add myContractReference to the list of references contained
         // in the discovery document.
         myDiscoveryDocument.References.Add(myContractReference);

         // Add Binding to the references collection.
         myDiscoveryDocument.References.Add(myBinding);

         // Open or create a file for writing.
         FileStream myFileStream = new FileStream("Service1.disco",
             FileMode.OpenOrCreate, FileAccess.Write );
         StreamWriter myStreamWriter = new StreamWriter( myFileStream );

         // Write myDiscoveryDocument into the passed stream.
         myDiscoveryDocument.Write( myStreamWriter );
         Console.WriteLine("The Service1.disco is generated.");
      }
      catch(Exception e)
      {
         Console.WriteLine("Error is "+ e.Message);
      }
   }
}

Imports System.Xml
Imports System.IO
Imports System.Web.Services.Discovery

Public Class MyContractReference
   Shared Sub Main()
      Try
         ' Get a 'DiscoveryDocument' object.
         Dim myDiscoveryDocument As New DiscoveryDocument()
         ' Get a 'ContractReference' object.
         Dim myContractReference As New ContractReference()
         ' Set the URL to the referenced service description.
         myContractReference.Ref = "http://localhost/service1.asmx?wsdl"
         ' Set the URL for a XML Web service implementing the service
         ' description .
         myContractReference.DocRef = "http://localhost/service1.asmx"
         Dim myBinding As New SoapBinding()
         myBinding.Binding = New XmlQualifiedName("q1:Service1Soap")
         myBinding.Address = "http://localhost/service1.asmx"
         ' Add 'myContractReference' to the list of references contained 
         ' within the discovery document.
         myDiscoveryDocument.References.Add(myContractReference)
         ' Add 'Binding' to referenceCollection.
         myDiscoveryDocument.References.Add(myBinding)
         ' Open or create a file for writing .
         Dim myFileStream As New FileStream("Service1.disco", FileMode.OpenOrCreate, FileAccess.Write)
         Dim myStreamWriter As New StreamWriter(myFileStream)
         ' Write 'myDiscoveryDocument' into the passed stream.
         myDiscoveryDocument.Write(myStreamWriter)
         Console.WriteLine("The 'Service1.disco' is generated.")
      Catch e As Exception
         Console.WriteLine("Error is" + e.Message)
      End Try
   End Sub
End Class

Remarques

La découverte des services Web XML implique la découverte des services Web disponibles en fonction d’une URL. L’URL pointe généralement vers un document de découverte, qui a généralement une extension de nom de fichier .disco. Dans un document de découverte figurent des références à des informations sur l’existence de services Web XML. Ces références peuvent faire référence à des descriptions de service, à des schémas XSD (XML Schema Definition Language) ou à d’autres documents de découverte. Cette classe représente une référence à une description de service.

Dans un document de découverte, une référence à une description de service est contenue dans un contractRef élément XML. L’élément contractRef XML a deux attributs : ref et docRef. L’élément contractRef doit avoir un espace de noms XML correspondant à la Namespace constante, tandis que les ref attributs et docRef sont placés dans les Ref propriétés et DocRef .

Constructeurs

ContractReference()	Initialise une nouvelle instance de la classe ContractReference à l'aide de valeurs par défaut.
ContractReference(String)	Initialise une nouvelle instance de la classe ContractReference à l'aide de la référence fournie à une description de service.
ContractReference(String, String)	Initialise une nouvelle instance de la classe ContractReference à l'aide des références fournies à une description de service et d'un service Web XML implémentant la description de service.

Champs

Namespace

Espace de noms XML pour des références de description de services dans des documents de découverte.

Propriétés

ClientProtocol	Obtient ou définit l'instance de DiscoveryClientProtocol utilisée dans un processus de découverte. (Hérité de DiscoveryReference)
Contract	Obtient un objet ServiceDescription représentant la description de service.
DefaultFilename	Obtient le nom du fichier à utiliser par défaut lors de l'enregistrement de la description du service référencé.
DocRef	Obtient ou définit l’URL d’un service web XML implémentant la description du service référencée dans la propriété Ref.
Ref	Obtient ou définit l'URL de la description du service référencé.
Url	Obtient ou définit l'URL de la description du service référencé.

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)
ReadDocument(Stream)	Lit la description du service à partir du Stream passé et retourne la description du service.
Resolve()	Télécharge le document référencé à partir de Url afin de savoir s'il est valide. (Hérité de DiscoveryReference)
Resolve(String, Stream)	Indique si le document référencé est valide.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
WriteDocument(Object, Stream)	Écrit la description du service passée dans le Stream passé.

S’applique à