SoapHeaderCollection.Item Property

Gets or sets the SoapHeader at the specified index of the SoapHeaderCollection.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

public:
property SoapHeader^ default [int] {
	SoapHeader^ get (int index);
	void set (int index, SoapHeader^ value);
}
/** @property */
public SoapHeader get_Item (int index)

/** @property */
public void set_Item (int index, SoapHeader value)

Not applicable.

Parameters

index

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

Property Value

The SoapHeader at the specified index.

Exception typeCondition

ArgumentOutOfRangeException

The index parameteris not a valid index in the SoapHeaderCollection.

This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[index].

// Check to see whether the collection contains mySecondSoapHeader.
if ( mySoapHeaderCollection->Contains( mySecondSoapHeader ) )
{
   // Get the index of mySecondSoapHeader from the collection.
   Console::WriteLine( "Index of mySecondSoapHeader: {0}", mySoapHeaderCollection->IndexOf( mySecondSoapHeader ) );

   // Get the SoapHeader from the collection.
   MySoapHeader^ mySoapHeader1 = dynamic_cast<MySoapHeader^>(mySoapHeaderCollection[ mySoapHeaderCollection->IndexOf( mySecondSoapHeader ) ]);
   Console::WriteLine( "SoapHeader retrieved from the collection: {0}", mySoapHeader1 );

   // Remove a SoapHeader from the collection.
   mySoapHeaderCollection->Remove( mySoapHeader1 );
   Console::WriteLine( "Number of items after removal: {0}", mySoapHeaderCollection->Count );
}
else
      Console::WriteLine( "mySoapHeaderCollection does not contain mySecondSoapHeader." );

// Check to see whether the collection contains mySecondSoapHeader.
if (mySoapHeaderCollection.Contains(mySecondSoapHeader)) {
    // Get the index of mySecondSoapHeader from the collection.
    Console.WriteLine("Index of mySecondSoapHeader: " 
        + mySoapHeaderCollection.IndexOf(mySecondSoapHeader));
    // Get the SoapHeader from the collection.
    MySoapHeader mySoapHeader1 = (MySoapHeader)mySoapHeaderCollection.
        get_Item(mySoapHeaderCollection.IndexOf(mySecondSoapHeader));
    Console.WriteLine("SoapHeader retrieved from the collection: " 
        + mySoapHeader1);
    // Remove a SoapHeader from the collection.
    mySoapHeaderCollection.Remove(mySoapHeader1);
    Console.WriteLine("Number of items after removal: {0}", 
        System.Convert.ToString(mySoapHeaderCollection.get_Count()));
}
else {
    Console.WriteLine("mySoapHeaderCollection does not contain "
        + "mySecondSoapHeader.");
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show: