MessageCollection.Item Property (String)

Gets a Message specified by its name.

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

public:
property Message^ default [String^] {
	Message^ get (String^ name);
}
/** @property */
public Message get_Item (String name)

Not applicable.

Parameters

name

The name of the Message returned.

Property Value

A Message.

The following example demonstrates the use of a string to retrieve a Message.

// Get Message by Name = S"AddSoapIn".
Message^ myMessage = myServiceDescription->Messages[ "AddSoapIn" ];
Console::WriteLine( "" );
Console::WriteLine( "Getting Message = 'AddSoapIn' {by Name}" );
if ( myMessageCollection->Contains( myMessage ) )
{
   Console::WriteLine( "" );

   // Get Message Name = S"AddSoapIn" Index.
   Console::WriteLine( "Message 'AddSoapIn' was found in Message Collection." );
   Console::WriteLine( "Index of 'AddSoapIn' in Message Collection = {0}", myMessageCollection->IndexOf( myMessage ) );
   Console::WriteLine( "Deleting Message from Message Collection..." );
   myMessageCollection->Remove( myMessage );
   if ( myMessageCollection->IndexOf( myMessage ) == -1 )
         Console::WriteLine( "Message 'AddSoapIn' was successfully removed from Message Collection." );
}

// Get Message by Name = "AddSoapIn".
Message myMessage = 
    myServiceDescription.get_Messages().get_Item("AddSoapIn");
Console.WriteLine("");
Console.WriteLine("Getting Message = 'AddSoapIn' {by Name}");
if (myMessageCollection.Contains(myMessage)) {
    Console.WriteLine("");

    // Get Message Name = "AddSoapIn" Index.
    Console.WriteLine("Message 'AddSoapIn' was found in "
        + "Message Collection.");
    Console.WriteLine("Index of 'AddSoapIn' in Message Collection = " 
        + myMessageCollection.IndexOf(myMessage));
    Console.WriteLine("Deleting Message from Message Collection...");
    myMessageCollection.Remove(myMessage);
    if (myMessageCollection.IndexOf(myMessage) == -1) {
        Console.WriteLine("Message 'AddSoapIn' was successfully "
            + "removed from Message Collection.");
    }
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, 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

Community Additions

ADD
Show: