ContractReference Classe

Definizione

Rappresenta un riferimento in un documento di individuazione a una descrizione di servizio.

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
Ereditarietà
ContractReference

Esempio

#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

Commenti

L'individuazione dei servizi Web XML comporta l'individuazione dei servizi Web disponibili in base a un URL. L'URL punta in genere a un documento di individuazione, che in genere ha un'estensione di file con estensione disco. All'interno di un documento di individuazione sono riportati riferimenti a informazioni sull'esistenza di servizi Web XML. Questi riferimenti possono fare riferimento alle descrizioni dei servizi, agli schemi XSD (XML Schema Definition Language) o ad altri documenti di individuazione. Questa classe rappresenta un riferimento a una descrizione del servizio.

All'interno di un documento di individuazione, un riferimento a una descrizione del servizio è contenuto all'interno di un contractRef elemento XML. L'elemento contractRef XML ha due attributi: ref e docRef. L'elemento contractRef deve avere uno spazio dei nomi XML corrispondente alla Namespace costante , mentre gli ref attributi e docRef vengono inseriti nelle Ref proprietà e DocRef .

Costruttori

ContractReference()

Inizializza una nuova istanza della classe ContractReference usando i valori predefiniti.

ContractReference(String)

Inizializza una nuova istanza della classe ContractReference utilizzando il riferimento fornito alla descrizione di servizio.

ContractReference(String, String)

Inizializza una nuova istanza della classe ContractReference, utilizzando i riferimenti forniti a una descrizione di servizio e a un servizio Web XML che implementa la descrizione di servizio.

Campi

Namespace

Spazio dei nomi XML per i riferimenti alle descrizioni di servizio nei documenti di individuazione.

Proprietà

ClientProtocol

Ottiene o imposta l'istanza di DiscoveryClientProtocol utilizzata in un processo di individuazione.

(Ereditato da DiscoveryReference)
Contract

Ottiene un oggetto ServiceDescription che rappresenta la descrizione di servizio.

DefaultFilename

Ottiene il nome del file da utilizzare per impostazione predefinita, quando si salva la descrizione di servizio a cui si fa riferimento.

DocRef

Ottiene o imposta l'URL di un servizio Web XML che implementa la descrizione di servizio a cui si fa riferimento nella proprietà Ref.

Ref

Ottiene o imposta l'URL della descrizione di servizio a cui si fa riferimento.

Url

Ottiene o imposta l'URL relativo alla descrizione di servizio a cui si fa riferimento.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ReadDocument(Stream)

Legge la descrizione di servizio dall'oggetto Stream passato e la restituisce.

Resolve()

Esegue il download del documento a cui si fa riferimento nella proprietà Url per stabilire se il documento è valido.

(Ereditato da DiscoveryReference)
Resolve(String, Stream)

Stabilisce se il documento cui si fa riferimento è valido.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteDocument(Object, Stream)

Inserisce la descrizione di servizio passata nell'oggetto Stream passato.

Si applica a

Vedi anche