This documentation is archived and is not being maintained.

DiscoveryReferenceCollection.Item Property

Gets or sets the DiscoveryReference at the specified index.

[C#] In C#, this property is the indexer for the DiscoveryReferenceCollection class.

[Visual Basic]
Public Default Property Item( _
   ByVal i As Integer _
) As DiscoveryReference
[C#]
public DiscoveryReference this[
 int i
] {get; set;}
[C++]
public: __property DiscoveryReference* get_Item(
 int i
);
public: __property void set_Item(
 int i,
   DiscoveryReference*
);
[JScript]
returnValue = DiscoveryReferenceCollectionObject.Item(i);
DiscoveryReferenceCollectionObject.Item(i) = returnValue;
-or-
returnValue = DiscoveryReferenceCollectionObject(i);
DiscoveryReferenceCollectionObject(i) = returnValue;

[JScript] In JScript, you can use the default indexed properties defined by a type, but you cannot explicitly define your own. However, specifying the expando attribute on a class automatically provides a default indexed property whose type is Object and whose index type is String.

Arguments [JScript]

i
The zero-based index of the DiscoveryReference to get or set.

Parameters [Visual Basic, C#, C++]

i
The zero-based index of the DiscoveryReference to get or set.

Property Value

The DiscoveryReference at the specified index.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException i is not a valid index in the DiscoveryReferenceCollection.

Example

[Visual Basic] 
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#] 
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++] 
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

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

See Also

DiscoveryReferenceCollection Class | DiscoveryReferenceCollection Members | System.Web.Services.Discovery Namespace

Show: