Freigeben über


MessageCollection.Insert-Methode

Fügt der MessageCollection die angegebene Message am angegebenen nullbasierten Index hinzu.

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

Syntax

'Declaration
Public Sub Insert ( _
    index As Integer, _
    message As Message _
)
'Usage
Dim instance As MessageCollection
Dim index As Integer
Dim message As Message

instance.Insert(index, message)
public void Insert (
    int index,
    Message message
)
public:
void Insert (
    int index, 
    Message^ message
)
public void Insert (
    int index, 
    Message message
)
public function Insert (
    index : int, 
    message : Message
)

Parameter

  • index
    Der nullbasierte Index, an dem der message-Parameter eingefügt werden soll.
  • message
    Die der Auflistung hinzuzufügende Message.

Ausnahmen

Ausnahmetyp Bedingung

IndexOutOfRangeException

Der index-Parameter ist kleiner als 0.

– oder –

Der index-Parameter ist größer als Count.

Hinweise

Wenn die Anzahl der Elemente in der Auflistung bereits der Kapazität der Auflistung entspricht, wird diese verdoppelt, indem das interne Array vor dem Einfügen des neuen Elements automatisch neu reserviert wird.

Wenn der index-Parameter gleich Count ist, wird der message-Parameter am Ende der MessageCollection hinzugefügt.

Die Elemente nach der Einfügemarke werden nach unten verschoben, um das neue Element aufnehmen zu können.

Beispiel

Dim myMessage1 As New Message()
myMessage1.Name = "AddSoapIn"
Dim myMessagePart1 As New MessagePart()
myMessagePart1.Name = "parameters"
myMessagePart1.Element = New XmlQualifiedName("Add", _
   myServiceDescription.TargetNamespace)
myMessage1.Parts.Insert(0, myMessagePart1)
myServiceDescription.Messages.Insert(16, myMessage1)
Message myMessage1 = new Message();
myMessage1.Name = "AddSoapIn";
MessagePart myMessagePart1 = new MessagePart();
myMessagePart1.Name = "parameters";
myMessagePart1.Element = new XmlQualifiedName("Add",myServiceDescription.TargetNamespace);
myMessage1.Parts.Insert(0,myMessagePart1);
myServiceDescription.Messages.Insert(16,myMessage1);
Message^ myMessage1 = gcnew Message;
myMessage1->Name = "AddSoapIn";
MessagePart^ myMessagePart1 = gcnew MessagePart;
myMessagePart1->Name = "parameters";
myMessagePart1->Element = gcnew XmlQualifiedName( "Add",myServiceDescription->TargetNamespace );
myMessage1->Parts->Insert( 0, myMessagePart1 );
myServiceDescription->Messages->Insert( 16, myMessage1 );

Plattformen

Windows 98, Windows 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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageCollection-Klasse
MessageCollection-Member
System.Web.Services.Description-Namespace