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
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