DiscoveryReference Klasse
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die Basisklasse für Verweise, die mit dem XML Web Services Discovery-Tool ermittelt werden können.
public ref class DiscoveryReference abstract
public abstract class DiscoveryReference
type DiscoveryReference = class
Public MustInherit Class DiscoveryReference
- Vererbung
-
DiscoveryReference
- Abgeleitet
#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
ContractReference, SchemaReference, und DiscoveryDocumentReference alle erben von DiscoveryReference, und die drei Typen von Dokumenten, die XML-Webdienstsuche erkennbaren darstellen: Dienstbeschreibungen, XML-Schemadefinition (XSD)-Schemas und Discovery-Dokumente bzw.
Discovery |
Initialisiert eine neue Instanz der DiscoveryReference-Klasse. |
Client |
Ruft die Instanz von DiscoveryClientProtocol ab, die in einem Discoveryvorgang verwendet wird, oder legt diese fest. |
Default |
Ruft den Namen der Standarddatei ab, die beim Speichern des Discovery-Dokuments, des XSD-Schemas bzw. der Dienstbeschreibung verwendet werden soll, auf das bzw. die verwiesen wird. |
Url |
Ruft die URL des Dokuments ab, auf das verwiesen wird, oder legt diese fest. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
Filename |
Gibt einen Dateinamen auf der Grundlage der übergebenen URL zurück. |
Get |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
Get |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
Memberwise |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
Read |
Liest den übergebenen Stream und gibt eine Instanz der Klasse zurück, die den Typ des Dokuments darstellt, auf das verwiesen wird. |
Resolve() |
Lädt das Dokument herunter, auf das verwiesen wird, unter Url, um seine Gültigkeit zu überprüfen. |
Resolve(String, Stream) |
Überprüft die Gültigkeit des Dokuments, auf das verwiesen wird. |
To |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Write |
Schreibt beim Überschreiben in einer abgeleiteten Klasse das Dokument in einen Stream. |