DiscoveryReference 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.
A classe base para referências descobertas usando a descoberta de serviços Web em XML.
public ref class DiscoveryReference abstract
public abstract class DiscoveryReference
type DiscoveryReference = class
Public MustInherit Class DiscoveryReference
- Herança
-
DiscoveryReference
- Derivado
Exemplos
#using <System.Xml.dll>
#using <System.Web.Services.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Web::Services::Discovery;
using namespace System::Net;
// Class derived from DiscoveryReference class and overriding it members.
ref class MyDiscoveryReferenceClass: public DiscoveryReference
{
private:
String^ myDocumentUrl;
public:
property String^ DefaultFilename
{
virtual String^ get() override
{
return "dataservice.disco";
}
}
virtual Object^ ReadDocument( Stream^ stream ) override
{
return stream;
}
void Resolve()
{
try
{
DiscoveryDocument^ myDiscoveryRefDocument;
myDiscoveryRefDocument = DiscoveryReference::ClientProtocol->Discover( Url );
}
catch ( Exception^ e )
{
throw e;
}
}
protected:
virtual void Resolve( String^ /*contentType*/, Stream^ /*stream*/ ) override {}
public:
property String^ Url
{
virtual String^ get() override
{
return myDocumentUrl;
}
virtual void set( String^ value ) override
{
myDocumentUrl = value;
}
}
virtual void WriteDocument( Object^ document, System::IO::Stream^ stream ) override
{
DiscoveryDocument^ myDiscoveryDocument = dynamic_cast<DiscoveryDocument^>(document);
myDiscoveryDocument->Write( stream );
}
};
int main()
{
try
{
DiscoveryDocument^ myDiscoveryDocument;
StreamReader^ myStreamReader = gcnew StreamReader( "c:\\Inetpub\\wwwroot\\dataservice.disco" );
FileStream^ myStream = gcnew FileStream( "c:\\MyDiscovery.disco",FileMode::OpenOrCreate );
Console::WriteLine( "Demonstrating DiscoveryReference class." );
// Read discovery file.
myDiscoveryDocument = DiscoveryDocument::Read( myStreamReader );
// Create a new instance of the DiscoveryReference class.
MyDiscoveryReferenceClass^ myDiscoveryReference;
myDiscoveryReference = gcnew MyDiscoveryReferenceClass;
DiscoveryClientProtocol^ myDiscoveryClientProtocol = gcnew DiscoveryClientProtocol;
myDiscoveryClientProtocol->Credentials = CredentialCache::DefaultCredentials;
// Set the client protocol.
myDiscoveryReference->ClientProtocol = myDiscoveryClientProtocol;
// Read the default file name.
Console::WriteLine( "Default file name is: {0}", myDiscoveryReference->DefaultFilename );
// Write the document.
myDiscoveryReference->WriteDocument( myDiscoveryDocument, myStream );
// Read the document.
myDiscoveryReference->ReadDocument( myStream );
// Set the URL.
myDiscoveryReference->Url = "http://localhost/dataservice.disco";
Console::WriteLine( "Url is: {0}", myDiscoveryReference->Url );
// Resolve the URL.
myDiscoveryReference->Resolve();
myStreamReader->Close();
myStream->Close();
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception caught! - {0}", e->Message );
}
}
using System;
using System.IO;
using System.Web.Services.Discovery;
using System.Net;
class MyDiscoveryDocumentClass
{
static void Main()
{
try {
DiscoveryDocument myDiscoveryDocument;
StreamReader myStreamReader =
new StreamReader("c:\\Inetpub\\wwwroot\\dataservice.disco");
FileStream myStream = new FileStream("c:\\MyDiscovery.disco",
FileMode.OpenOrCreate);
Console.WriteLine("Demonstrating DiscoveryReference class.");
// Read discovery file.
myDiscoveryDocument = DiscoveryDocument.Read(myStreamReader);
// Create a new instance of the DiscoveryReference class.
MyDiscoveryReferenceClass myDiscoveryReference;
myDiscoveryReference = new MyDiscoveryReferenceClass();
DiscoveryClientProtocol myDiscoveryClientProtocol =
new DiscoveryClientProtocol();
myDiscoveryClientProtocol.Credentials =
CredentialCache.DefaultCredentials;
// Set the client protocol.
myDiscoveryReference.ClientProtocol = myDiscoveryClientProtocol;
// Read the default file name.
Console.WriteLine("Default file name is: "
+ myDiscoveryReference.DefaultFilename);
// Write the document.
myDiscoveryReference.WriteDocument(myDiscoveryDocument,myStream);
// Read the document.
myDiscoveryReference.ReadDocument(myStream);
// Set the URL.
myDiscoveryReference.Url = "http://localhost/dataservice.disco";
Console.WriteLine("Url is: " + myDiscoveryReference.Url);
// Resolve the URL.
myDiscoveryReference.Resolve();
myStreamReader.Close();
myStream.Close();
}
catch (Exception e)
{
Console.WriteLine("Exception caught! - {0}", e.Message);
}
}
}
// Class derived from DiscoveryReference class and overriding it members.
class MyDiscoveryReferenceClass : DiscoveryReference
{
private string myDocumentUrl;
public override string DefaultFilename
{
get
{
return "dataservice.disco";
}
}
public override object ReadDocument(Stream stream)
{
return stream;
}
public new void Resolve()
{
try
{
DiscoveryDocument myDiscoveryRefDocument;
myDiscoveryRefDocument = base.ClientProtocol.Discover(Url);
}
catch (Exception e)
{
throw(e);
}
}
protected override void Resolve(string contentType, Stream stream) {}
public override string Url
{
get
{
return myDocumentUrl;
}
set
{
myDocumentUrl = value;
}
}
public override void WriteDocument(object document, System.IO.Stream stream)
{
DiscoveryDocument myDiscoveryDocument = (DiscoveryDocument)document;
myDiscoveryDocument.Write(stream);
}
}
Imports System.IO
Imports System.Web.Services.Discovery
Imports System.Net
Class MyDiscoveryDocumentClass
Public Shared Sub Main()
Try
Dim myDiscoveryDocument As DiscoveryDocument
Dim myStreamReader As New StreamReader("c:\Inetpub\wwwroot\dataservice.disco")
Dim myStream As New FileStream("c:\MyDiscovery.disco", FileMode.OpenOrCreate)
Console.WriteLine("Demonstrating DiscoveryReference class.")
' Read the discovery file.
myDiscoveryDocument = DiscoveryDocument.Read(myStreamReader)
' Create an instance of the DiscoveryReference class.
Dim myDiscoveryReference As MyDiscoveryReferenceClass
myDiscoveryReference = New MyDiscoveryReferenceClass()
Dim myDiscoveryClientProtocol As New DiscoveryClientProtocol()
myDiscoveryClientProtocol.Credentials = _
CredentialCache.DefaultCredentials
' Set the client protocol.
myDiscoveryReference.ClientProtocol = myDiscoveryClientProtocol
' Read the default file name.
Console.WriteLine("Default file name is: " _
& myDiscoveryReference.DefaultFilename)
' Write the document.
myDiscoveryReference.WriteDocument(myDiscoveryDocument, myStream)
' Read the document.
myDiscoveryReference.ReadDocument(myStream)
' Set the URL.
myDiscoveryReference.Url = "http://localhost/dataservice.disco"
Console.WriteLine("Url is : " + myDiscoveryReference.Url)
' Resolve the URL.
myDiscoveryReference.Resolve()
myStreamReader.Close()
myStream.Close()
Catch e as Exception
Console.WriteLine("Exception caught! - {0}", e.Message)
End Try
End Sub
End Class
' Class derived from DiscoveryReference class and overriding it members.
Class MyDiscoveryReferenceClass
Inherits DiscoveryReference
Private myDocumentUrl As String
Public Overrides ReadOnly Property DefaultFilename() As String
Get
Return "dataservice.disco"
End Get
End Property
Public Overrides Function _
ReadDocument(ByVal stream As System.IO.Stream) As Object
Return stream
End Function
Public Overloads Sub Resolve()
Try
Dim myDiscoveryRefDocument As DiscoveryDocument
myDiscoveryRefDocument = MyBase.ClientProtocol.Discover(Url)
Catch e As Exception
Throw e
End Try
End Sub
Protected Overloads Overrides Sub _
Resolve(ByVal contentType As String, ByVal stream As Stream)
End Sub
Public Overrides Property Url() As String
Get
Return myDocumentUrl
End Get
Set(ByVal Value As String)
myDocumentUrl = Value
End Set
End Property
Public Overrides Sub WriteDocument _
(ByVal document As Object, ByVal stream As System.IO.Stream)
Dim myDiscoveryDocument As DiscoveryDocument = _
CType(document, DiscoveryDocument)
myDiscoveryDocument.Write(stream)
End Sub
End Class
Observações
ContractReference, SchemaReference, e DiscoveryDocumentReference todos herdam de DiscoveryReference, e representam os três tipos de documentos que podem ser descobertos através da descoberta de serviços Web em XML: Descrições de Serviços, esquemas XML Schema Definition (XSD) e documentos de descoberta, respetivamente.
Construtores
| Name | Description |
|---|---|
| DiscoveryReference() |
Inicializa uma nova instância da DiscoveryReference classe. |
Propriedades
| Name | Description |
|---|---|
| ClientProtocol |
Obtém ou define a instância de DiscoveryClientProtocol utilizada num processo de descoberta. |
| DefaultFilename |
Obtém o nome do ficheiro predefinido a usar ao guardar o documento de descoberta referenciado, o esquema XSD ou a Descrição do Serviço. |
| Url |
Obtém ou define a URL do documento referenciado. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FilenameFromUrl(String) |
Devolve um nome de ficheiro com base no URL passado. |
| 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ê o passado Stream e devolve uma instância da classe que representa o tipo de documento referenciado. |
| Resolve() |
Descarrega o documento referenciado em Url para determinar se o documento referenciado é válido. |
| 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) |
Quando sobrescrito numa classe derivada, escreve o documento para um Stream. |