DiscoveryReference Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Classe de base pour les références à découvrir à l'aide de services Web XML.
public ref class DiscoveryReference abstract
public abstract class DiscoveryReference
type DiscoveryReference = class
Public MustInherit Class DiscoveryReference
- Héritage
-
DiscoveryReference
- Dérivé
Exemples
#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
Remarques
ContractReference, SchemaReferenceet DiscoveryDocumentReference tous héritent DiscoveryReference, et représentent les trois types de documents détectables via la découverte de services Web XML : Descriptions de service, schémas XSD (XML Schema Definition) et documents de découverte, respectivement.
Constructeurs
DiscoveryReference() |
Initialise une nouvelle instance de la classe DiscoveryReference. |
Propriétés
ClientProtocol |
Obtient ou définit l'instance de DiscoveryClientProtocol utilisée dans un processus de découverte. |
DefaultFilename |
Obtient le nom du fichier par défaut à utiliser lorsque vous enregistrez le document de découverte, le schéma XSD ou la description de service référencés. |
Url |
Obtient ou définit l'URL du document référencé. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
FilenameFromUrl(String) |
Retourne un nom de fichier basé sur l'URL passée. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ReadDocument(Stream) |
Lit le Stream passé et retourne une instance de la classe représentant le type de document référencé. |
Resolve() |
Télécharge le document référencé à partir de Url afin de savoir s'il est valide. |
Resolve(String, Stream) |
Indique si le document référencé est valide. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
WriteDocument(Object, Stream) |
En cas de substitution dans une classe dérivée, il écrit le document dans Stream. |