ContractReference Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Services.Discovery

Assembly:: System.Web.Services.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object

DiscoveryReference
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