ContractReference Classe

Referência

Definição

Namespace:: System.Web.Services.Discovery

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

DiscoveryReference
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. Em 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 os ref atributos e docRef são colocados nas Ref propriedades e DocRef .

Construtores

ContractReference()	Inicializa uma nova instância da classe ContractReference usando valores padrão.
ContractReference(String)	Inicializa uma nova instância da classe ContractReference usando a referência fornecida a uma Descrição do Serviço.
ContractReference(String, String)	Inicializa uma nova instância da classe ContractReference usando as referências fornecidas a uma descrição do serviço e um serviço Web XML que implementa a descrição do serviço.

Campos

Namespace

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

Propriedades

ClientProtocol	Obtém ou define a instância de DiscoveryClientProtocol usado em um processo de descoberta. (Herdado de DiscoveryReference)
Contract	Obtém um objeto ServiceDescription 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 referenciado na propriedade Ref.
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 referenciado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ReadDocument(Stream)	Lê a descrição do serviço do Stream passado e retorna a descrição do serviço.
Resolve()	Baixa o documento referenciado em Url 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 no Stream passado.

Aplica-se a

Partilhar via