This documentation is archived and is not being maintained.

DiscoveryReferenceCollection Class

A collection of discovery references. This class cannot be inherited.

For a list of all members of this type, see DiscoveryReferenceCollection Members.

System.Object
   System.Collections.CollectionBase
      System.Web.Services.Discovery.DiscoveryReferenceCollection

[Visual Basic]
NotInheritable Public Class DiscoveryReferenceCollection
   Inherits CollectionBase
[C#]
public sealed class DiscoveryReferenceCollection : CollectionBase
[C++]
public __gc __sealed class DiscoveryReferenceCollection : public
   CollectionBase
[JScript]
public class DiscoveryReferenceCollection extends CollectionBase

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Example

[Visual Basic] 
Imports System
Imports System.IO
Imports System.Web.Services.Discovery

Class MyDiscoveryDocumentMod

   Shared Sub Main()
   Try
      Dim myDiscoveryDocReference1 As New DiscoveryDocumentReference()
      Dim myDiscoveryDocReference2 As New DiscoveryDocumentReference()
      Dim myDiscoveryReference As DiscoveryReference

      Console.WriteLine("Demonstrating DiscoveryReferenceCollection class.")

      ' Create new DiscoveryReferenceCollection.
      Dim myDiscoveryReferenceCollection As New DiscoveryReferenceCollection()

      ' Access the Count method.
      Console.WriteLine("The number of elements in collection is: " & _
         myDiscoveryReferenceCollection.Count.ToString())

      ' Add elements to the collection.
      myDiscoveryReferenceCollection.Add(myDiscoveryDocReference1)
      myDiscoveryReferenceCollection.Add(myDiscoveryDocReference2)

      Console.WriteLine("The number of elements in the collection " _
         & "after adding two elements to the collection: " _
         & myDiscoveryReferenceCollection.Count.ToString())

      ' Call the Contains method.
      If myDiscoveryReferenceCollection.Contains(myDiscoveryDocReference1) _
         <> True Then
         Throw New Exception("Element not found in collection.")
      End If

      ' Access the Item property.
      myDiscoveryReference = myDiscoveryReferenceCollection.Item(0)

      If  myDiscoveryReference Is Nothing Then
         Throw New Exception("Element not found in collection.")
      End If

      ' Remove one element from the collection.
      myDiscoveryReferenceCollection.Remove(myDiscoveryDocReference1)
      Console.WriteLine("The number of elements in collection " _
         & "after removing one element is: " _
         & myDiscoveryReferenceCollection.Count.ToString())

   Catch e As Exception
       Console.Writeline("Exception occured : " + e.Message)
   End Try
   End Sub

End Class

[C#] 
using System;
using System.IO;
using System.Web.Services.Discovery;

class MyDiscoveryDocumentClass
{
   static void Main()
   {
      DiscoveryDocumentReference myDiscoveryDocReference1 = 
         new DiscoveryDocumentReference();
      DiscoveryDocumentReference myDiscoveryDocReference2 = 
         new DiscoveryDocumentReference();
      DiscoveryReference myDiscoveryReference;

      Console.WriteLine("Demonstrating DiscoveryReferenceCollection class.");
     
      // Create new DiscoveryReferenceCollection.
      DiscoveryReferenceCollection myDiscoveryReferenceCollection = 
         new DiscoveryReferenceCollection();

      // Access the Count method.
      Console.WriteLine("The number of elements in the collection is: " 
         + myDiscoveryReferenceCollection.Count.ToString());

      // Add elements to the collection.
      myDiscoveryReferenceCollection.Add(myDiscoveryDocReference1);
      myDiscoveryReferenceCollection.Add(myDiscoveryDocReference2);

      Console.WriteLine("The number of elements in the collection "
         + "after adding two elements to the collection: " 
         + myDiscoveryReferenceCollection.Count.ToString());

      // Call the Contains method.
      if (myDiscoveryReferenceCollection.Contains(myDiscoveryDocReference1) 
         != true)
      {
         throw new Exception("Element not found in collection.");
      }

      // Access the indexed member.
      myDiscoveryReference = 
         (DiscoveryReference)myDiscoveryReferenceCollection[0];
      if (myDiscoveryReference == null)
      {
         throw new Exception("Element not found in collection.");
      }

      // Remove one element from collection.
      myDiscoveryReferenceCollection.Remove(myDiscoveryDocReference1);
      Console.WriteLine("The number of elements in the collection "
         + "after removing one element is: " 
         + myDiscoveryReferenceCollection.Count.ToString());
   }
}

[C++] 
#using <mscorlib.dll>
#using <System.Web.Services.dll>
using namespace System;
using namespace System::IO;
using namespace System::Web::Services::Discovery;

int main() {
   DiscoveryDocumentReference* myDiscoveryDocReference1 =
      new DiscoveryDocumentReference();
   DiscoveryDocumentReference* myDiscoveryDocReference2 =
      new DiscoveryDocumentReference();
   DiscoveryReference* myDiscoveryReference;

   Console::WriteLine(S"Demonstrating DiscoveryReferenceCollection class.");

   // Create new DiscoveryReferenceCollection.
   DiscoveryReferenceCollection* myDiscoveryReferenceCollection =
      new DiscoveryReferenceCollection();

   // Access the Count method.
   Console::WriteLine(S"The number of elements in the collection is: {0}", 
      __box(myDiscoveryReferenceCollection->Count));

   // Add elements to the collection.
   myDiscoveryReferenceCollection->Add(myDiscoveryDocReference1);
   myDiscoveryReferenceCollection->Add(myDiscoveryDocReference2);

   Console::WriteLine(S"The number of elements in the collection after adding two elements to the collection: {0}", 
      __box(myDiscoveryReferenceCollection->Count));

   // Call the Contains method.
   if (myDiscoveryReferenceCollection->Contains(myDiscoveryDocReference1)
      != true) {
         throw new Exception(S"Element not found in collection.");
      }

      // Access the indexed member.
      myDiscoveryReference =
         dynamic_cast<DiscoveryReference*>(myDiscoveryReferenceCollection->Item[0]);
      if (myDiscoveryReference == 0) {
         throw new Exception(S"Element not found in collection.");
      }

      // Remove one element from collection.
      myDiscoveryReferenceCollection->Remove(myDiscoveryDocReference1);
      Console::WriteLine(S"The number of elements in the collection after removing one element is: {0}", 
         __box(myDiscoveryReferenceCollection->Count));
}

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

Requirements

Namespace: System.Web.Services.Discovery

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

Assembly: System.Web.Services (in System.Web.Services.dll)

See Also

DiscoveryReferenceCollection Members | System.Web.Services.Discovery Namespace

Show: