DiscoveryReference.Resolve Method

Definition

Namespace:

System.Web.Services.Discovery

Assembly:

System.Web.Services.dll

Resolves whether the referenced document is valid.

Overloads

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.

Resolve()

Downloads the referenced document at Url to resolve whether the referenced document is valid.

public:
 void Resolve();

public void Resolve ();

member this.Resolve : unit -> unit

Public Sub Resolve ()

Exceptions

InvalidOperationException

The ClientProtocol property is null.

Examples

#using <System.dll>
#using <System.Xml.dll>
#using <System.Web.Services.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 its 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 = __super::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()
{
   DiscoveryDocument^ myDiscoveryDocument;
   StreamReader^ myStreamReader = gcnew StreamReader( "c:\\Inetpub\\wwwroot\\dataservice.disco" );
   FileStream^ myStream = gcnew FileStream( "C:\\MyDiscovery.disco",FileMode::OpenOrCreate );
   Console::WriteLine( "Demonstrating Discovery Reference class." );
   
   // Read discovery file.
   myDiscoveryDocument = DiscoveryDocument::Read( myStreamReader );
   
   // Variable of type DiscoveryReference class defined.
   MyDiscoveryReferenceClass^ myDiscoveryReference;
   myDiscoveryReference = gcnew MyDiscoveryReferenceClass;
   DiscoveryClientProtocol^ myDiscoveryClientProtocol = gcnew DiscoveryClientProtocol;
   myDiscoveryClientProtocol->Credentials = CredentialCache::DefaultCredentials;
   
   // Set 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();
}

using System;
using System.IO;
using System.Web.Services.Discovery;
using System.Net;

class MyDiscoveryDocumentClass
{
   static void Main()
   {
      DiscoveryDocument myDiscoveryDocument;
      StreamReader myStreamReader =
         new StreamReader("c:\\Inetpub\\wwwroot\\dataservice.disco");
      FileStream myStream =
         new FileStream("C:\\MyDiscovery.disco",FileMode.OpenOrCreate);
      Console.WriteLine("Demonstrating Discovery Reference class.");

      // Read discovery file.
      myDiscoveryDocument = DiscoveryDocument.Read(myStreamReader);

      // Variable of type DiscoveryReference class defined.
      MyDiscoveryReferenceClass myDiscoveryReference;
      myDiscoveryReference =  new MyDiscoveryReferenceClass();

      DiscoveryClientProtocol myDiscoveryClientProtocol =
         new DiscoveryClientProtocol();
      myDiscoveryClientProtocol.Credentials =
         CredentialCache.DefaultCredentials;

      // Set 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();
   }
}

// Class derived from DiscoveryReference class and overriding its 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()

      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 Discovery Reference class.")

      ' Read discovery file.
      myDiscoveryDocument = DiscoveryDocument.Read(myStreamReader)

      ' Variable of type DiscoveryReference class defined.
      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()
   End Sub

End Class


' Class derived from DiscoveryReference class and overriding its 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

Remarks

Downloads the referenced document and then invokes the overloaded Resolve member that takes a MIME type and a Stream. If the MIME type and the contents of stream match those expected by the reference type, then the contents of stream are added to the References and Documents properties of ClientProtocol.

Resolve(String, Stream)

Resolves whether the referenced document is valid.

protected public:
 abstract void Resolve(System::String ^ contentType, System::IO::Stream ^ stream);

protected internal abstract void Resolve (string contentType, System.IO.Stream stream);

abstract member Resolve : string * System.IO.Stream -> unit

Protected Friend MustOverride Sub Resolve (contentType As String, stream As Stream)

Parameters

contentType

String

The MIME type of stream.

stream

Stream

The Stream containing the referenced document.

Remarks

If the MIME type and the contents of stream match those expected by the reference type, then the contents of stream are added to the References and Documents properties of ClientProtocol.