MessageCollection.Insert メソッド

.NET Framework クラス ライブラリ リファレンス

MessageCollection.Insert メソッド

指定した 0 から始まるインデックス番号にある MessageCollection に、指定した Message を追加します。

名前空間: System.Web.Services.Description
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Sub Insert ( _
    index As Integer, _
    message As Message _
)

Visual Basic (使用法)

Dim instance As MessageCollection
Dim index As Integer
Dim message As Message

instance.Insert(index, message)

C#

public void Insert (
    int index,
    Message message
)

C++

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

J#

public void Insert (
    int index, 
    Message message
)

JScript

public function Insert (
    index : int, 
    message : Message
)

パラメータ

index

message パラメータを挿入する位置の、0 から始まるインデックス番号。

message

コレクションに追加する Message。

例外

例外の種類	条件
IndexOutOfRangeException	index パラメータが 0 未満です。 または index パラメータが Count より大きい値です。

解説

コレクション内の項目数が既にコレクションの許容量に達している場合は、新しい要素が挿入される前に、内部配列を自動的に再割り当てすることによってコレクションの容量が 2 倍になります。

index パラメータと Count が等しい場合は、message パラメータが MessageCollection の末尾に追加されます。

新しい要素を挿入するために、挿入位置より後にある要素の位置が繰り下げられます。

使用例

Visual Basic

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)

C#

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

C++

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
MessageCollection クラス
MessageCollection メンバ
System.Web.Services.Description 名前空間