ContractReference Clase

Definición

Representa una referencia de un documento de detección a una descripción del servicio.

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
Herencia
ContractReference

Ejemplos

#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

Comentarios

La detección de servicios web XML implica detectar los servicios web disponibles según una dirección URL. La dirección URL suele apuntar a un documento de detección, que normalmente tiene una extensión de nombre de archivo.disco. Dentro de un documento de detección se hace referencia a información sobre la existencia de servicios web XML. Estas referencias pueden hacer referencia a descripciones de servicio, esquemas del lenguaje de definición de esquemas XML (XSD) u otros documentos de detección. Esta clase representa una referencia a una descripción del servicio.

Dentro de un documento de detección, una referencia a una descripción del servicio se encuentra dentro de un contractRef elemento XML. El contractRef elemento XML tiene dos atributos: ref y docRef. El contractRef elemento debe tener un espacio de nombres XML que coincida con la Namespace constante, mientras que los ref atributos y docRef se colocan en las Ref propiedades y DocRef .

Constructores

Nombre Description
ContractReference()

Inicializa una nueva instancia de la ContractReference clase con valores predeterminados.

ContractReference(String, String)

Inicializa una nueva instancia de la ContractReference clase utilizando las referencias proporcionadas a una descripción del servicio y un servicio web XML que implementa la descripción del servicio.

ContractReference(String)

Inicializa una nueva instancia de la ContractReference clase utilizando la referencia proporcionada a una descripción del servicio.

Campos

Nombre Description
Namespace

Espacio de nombres XML para referencias de descripción del servicio en documentos de detección.

Propiedades

Nombre Description
ClientProtocol

Obtiene o establece la instancia de usada en un proceso de DiscoveryClientProtocol detección.

(Heredado de DiscoveryReference)
Contract

Obtiene un ServiceDescription objeto que representa la descripción del servicio.

DefaultFilename

Obtiene el nombre del archivo que se va a usar de forma predeterminada al guardar la descripción del servicio al que se hace referencia.

DocRef

Obtiene o establece la dirección URL de un servicio web XML que implementa la descripción del servicio a la que se hace referencia en la Ref propiedad .

Ref

Obtiene o establece la dirección URL en la descripción del servicio al que se hace referencia.

Url

Obtiene o establece la dirección URL de la descripción del servicio a la que se hace referencia.

Métodos

Nombre Description
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ReadDocument(Stream)

Lee la descripción del servicio del pasado Stream y devuelve la descripción del servicio.

Resolve()

Descarga el documento Url al que se hace referencia para resolver si el documento al que se hace referencia es válido.

(Heredado de DiscoveryReference)
Resolve(String, Stream)

Resuelve si el documento al que se hace referencia es válido.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
WriteDocument(Object, Stream)

Escribe la descripción del servicio pasado en Streamel elemento pasado.

Se aplica a

Consulte también