ContractReference Clase

Referencia

Definición

Espacio de nombres:: System.Web.Services.Discovery

Ensamblado:: System.Web.Services.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa una referencia a una descripción de servicios en un documento de descubrimiento.

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

DiscoveryReference
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. Normalmente, la dirección URL apunta a un documento de descubrimiento que normalmente tiene la extensión de nombre de archivo a.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

ContractReference()	Inicializa una nueva instancia de la clase ContractReference con los valores predeterminados.
ContractReference(String)	Inicializa una nueva instancia de la clase ContractReference utilizando la referencia a una descripción de servicios proporcionada.
ContractReference(String, String)	Inicializa una nueva instancia de la clase ContractReference utilizando las referencias proporcionadas a una descripción de servicios y un servicio Web XML que implementa la descripción de servicios.

Campos

Namespace

Espacio de nombres XML para referencias de descripciones de servicios en documentos de descubrimiento.

Propiedades

ClientProtocol	Obtiene o establece la instancia de DiscoveryClientProtocol que se utiliza en un proceso de descubrimiento. (Heredado de DiscoveryReference)
Contract	Obtiene un objeto ServiceDescription que representa la descripción de servicios.
DefaultFilename	Obtiene el nombre del archivo que se va a utilizar de forma predeterminada cuando se guarde la descripción de servicios a la que se hace referencia.
DocRef	Obtiene o establece la dirección URL de un servicio Web XML que implementa la descripción de servicios a la que se hace referencia en la propiedad Ref.
Ref	Obtiene o establece la dirección URL a la descripción de servicios a la que se hace referencia.
Url	Obtiene o establece la dirección URL de la descripción de servicios a la que se hace referencia.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve 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 Object actual. (Heredado de Object)
ReadDocument(Stream)	Lee la descripción de servicios de Stream que se ha pasado y devuelve la descripción de servicios.
Resolve()	Descarga el documento al que se hace referencia en Url para resolver si este documento 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 de servicios que se ha pasado en Stream que se ha pasado.

Se aplica a

Compartir vía