ClientProtocol Property

Gets or sets the instance of DiscoveryClientProtocol used in a discovery process.

[Visual Basic]
Public Property ClientProtocol As DiscoveryClientProtocol
[C#]
public DiscoveryClientProtocol ClientProtocol {get; set;}
[C++]
public: __property DiscoveryClientProtocol* get_ClientProtocol();
public: __property void set_ClientProtocol(DiscoveryClientProtocol*);
[JScript]
public function get ClientProtocol() : DiscoveryClientProtocol;
public function set ClientProtocol(DiscoveryClientProtocol);

Property Value

An instance of DiscoveryClientProtocol used in a discovery process

Example

[Visual Basic] 
Imports System
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


[C#] 
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);
   }
}


[C++] 
#using <mscorlib.dll>
#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.
__gc class MyDiscoveryReferenceClass : public DiscoveryReference {
private:
   String*  myDocumentUrl;
public:
__property String* get_DefaultFilename() {
         return S"dataservice.disco";
      }


public:
   Object* ReadDocument(Stream* stream) {
      return stream;
   }

public:
   void Resolve() {
      try {
         DiscoveryDocument* myDiscoveryRefDocument;
         myDiscoveryRefDocument = __super::ClientProtocol->Discover(Url);
      } catch (Exception* e) {
         throw(e);
      }
   }

protected:
   void Resolve(String* contentType, Stream* stream) {}

public:
__property String* get_Url() {
         return myDocumentUrl;
      }
__property void set_Url(String* value) {
         myDocumentUrl = value;
      }


public:
   void WriteDocument(Object* document, System::IO::Stream* stream) {
      DiscoveryDocument* myDiscoveryDocument = 
         dynamic_cast<DiscoveryDocument*>(document);
      myDiscoveryDocument->Write(stream);
   }
};

int main() {
   DiscoveryDocument* myDiscoveryDocument;
   StreamReader* myStreamReader = 
      new StreamReader(S"c:\\Inetpub\\wwwroot\\dataservice.disco");
   FileStream* myStream = 
      new FileStream(S"C:\\MyDiscovery.disco", FileMode::OpenOrCreate);
   Console::WriteLine(S"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(S"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 = S"http://localhost/dataservice.disco";
   Console::WriteLine(S"Url is: {0}", myDiscoveryReference->Url);

   // Resolve the URL.
   myDiscoveryReference->Resolve();

   myStreamReader->Close();
   myStream->Close();
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

DiscoveryReference.ClientProtocol Property

Property Value

Example

Requirements

See Also