ContractReference Classe

Definição

Representa uma referência num documento de descoberta a uma descrição de serviço.

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
Herança
ContractReference

Exemplos

#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

Observações

A descoberta de serviços Web XML envolve a descoberta dos Serviços Web disponíveis com uma URL. O URL normalmente aponta para um documento de descoberta, que normalmente tem uma extensão de nome de ficheiro .disco. Dentro de um documento de descoberta existem referências a informações sobre a existência de serviços Web XML. Estas referências podem referir-se a descrições de serviços, esquemas XML Schema Definition Language (XSD) ou outros documentos de descoberta. Esta classe representa uma referência a uma Descrição de Serviço.

Dentro de um documento de descoberta, uma referência a uma Descrição de Serviço está contida num contractRef elemento XML. O contractRef elemento XML tem dois atributos: ref e docRef. O contractRef elemento deve ter um namespace XML correspondente à Namespace constante, enquanto os ref atributos e docRef são colocados nas Ref propriedades e.DocRef

Construtores

Name Description
ContractReference()

Inicializa uma nova instância da ContractReference classe usando valores por defeito.

ContractReference(String, String)

Inicializa uma nova instância da ContractReference classe usando as referências fornecidas a uma descrição de serviço e a um serviço Web XML que implementa a descrição do serviço.

ContractReference(String)

Inicializa uma nova instância da ContractReference classe usando a referência fornecida a uma Descrição de Serviço.

Campos

Name Description
Namespace

Espaço de nomes XML para referências de descrição de serviços em documentos de descoberta.

Propriedades

Name Description
ClientProtocol

Obtém ou define a instância de DiscoveryClientProtocol utilizada num processo de descoberta.

(Herdado de DiscoveryReference)
Contract

Obtém um ServiceDescription objeto que represente a descrição do serviço.

DefaultFilename

Obtém o nome do ficheiro a usar por defeito ao guardar a descrição do serviço referenciado.

DocRef

Obtém ou define a URL de um serviço Web XML que implementa a descrição do serviço referenciada na Ref propriedade.

Ref

Obtém ou define o URL para a descrição do serviço referenciado.

Url

Obtém ou define o URL para a Descrição do Serviço referenciada.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ReadDocument(Stream)

Lê a descrição do serviço do documento passado Stream e devolve a descrição do serviço.

Resolve()

Descarrega o documento referenciado em Url para determinar se o documento referenciado é válido.

(Herdado de DiscoveryReference)
Resolve(String, Stream)

Resolve se o documento referenciado é válido.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
WriteDocument(Object, Stream)

Escreve a descrição do serviço passado na Streamentrada passada .

Aplica-se a

Ver também