ContractReference Classe

Definição

Representa uma referência em um documento de descoberta para 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

Comentários

A descoberta de serviços Web XML envolve a descoberta dos Serviços Web disponíveis, considerando uma URL. A URL geralmente aponta para um documento de descoberta, que normalmente tem uma extensão de nome de arquivo.disco. Dentro de um documento de descoberta há referências a informações sobre a existência de serviços Web XML. Essas referências podem se referir a descrições de serviço, esquemas XSD (linguagem de definição de esquema XML) ou outros documentos de descoberta. Essa classe representa uma referência a uma Descrição do Serviço.

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

Construtores

Nome Description
ContractReference()

Inicializa uma nova instância da ContractReference classe usando valores padrão.

ContractReference(String, String)

Inicializa uma nova instância da ContractReference classe usando as referências fornecidas para uma descrição de serviço e um serviço Web XML implementando 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 do Serviço.

Campos

Nome Description
Namespace

Namespace XML para referências de descrição de serviço em documentos de descoberta.

Propriedades

Nome Description
ClientProtocol

Obtém ou define a instância de usada em um processo de DiscoveryClientProtocol descoberta.

(Herdado de DiscoveryReference)
Contract

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

DefaultFilename

Obtém o nome do arquivo a ser usado por padrão ao salvar 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 a URL para a descrição do serviço referenciado.

Url

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

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ReadDocument(Stream)

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

Resolve()

Baixa o documento Url referenciado para resolver se o documento referenciado é válido.

(Herdado de DiscoveryReference)
Resolve(String, Stream)

Resolve se o documento referenciado é válido.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
WriteDocument(Object, Stream)

Grava a descrição do serviço passado na entrada Stream.

Aplica-se a

Confira também