DiscoveryReference Class
The base class for discoverable references using XML Web services discovery.
Assembly: System.Web.Services (in System.Web.Services.dll)
System.Web.Services.Discovery.DiscoveryReference
System.Web.Services.Discovery.ContractReference
System.Web.Services.Discovery.DiscoveryDocumentReference
System.Web.Services.Discovery.SchemaReference
| Name | Description | |
|---|---|---|
![]() | DiscoveryReference() | Initializes a new instance of the DiscoveryReference class. |
| Name | Description | |
|---|---|---|
![]() | ClientProtocol | Gets or sets the instance of DiscoveryClientProtocol used in a discovery process. |
![]() | DefaultFilename | Gets the name of the default file to use when saving the referenced discovery document, XSD schema, or Service Description. |
![]() | Url | Gets or sets the URL of the referenced document. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() ![]() | FilenameFromUrl(String) | Returns a file name based on the passed URL. |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | MemberwiseClone() | |
![]() | ReadDocument(Stream) | Reads the passed Stream and returns an instance of the class representing the type of referenced document. |
![]() | Resolve() | Downloads the referenced document at Url to resolve whether the referenced document is valid. |
![]() | Resolve(String, Stream) | Resolves whether the referenced document is valid. |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
![]() | WriteDocument(Object, Stream) | When overridden in a derived class, writes the document to a Stream. |
ContractReference, SchemaReference, and DiscoveryDocumentReference all inherit from DiscoveryReference, and represent the three types of documents discoverable through XML Web services discovery: Service Descriptions, XML Schema Definition (XSD) schemas, and discovery documents, respectively.
Imports System 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
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.



