ContractReference Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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 . |