WebReferenceCollection.Insert メソッド

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

WebReferenceCollection.Insert メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したインデックス位置に指定した WebReference インスタンスを挿入します。

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

Visual Basic (宣言)

Public Sub Insert ( _
    index As Integer, _
    webReference As WebReference _
)

Visual Basic (使用法)

Dim instance As WebReferenceCollection
Dim index As Integer
Dim webReference As WebReference

instance.Insert(index, webReference)

C#

public void Insert (
    int index,
    WebReference webReference
)

C++

public:
void Insert (
    int index, 
    WebReference^ webReference
)

J#

public void Insert (
    int index, 
    WebReference webReference
)

JScript

public function Insert (
    index : int, 
    webReference : WebReference
)

パラメータ

index

指定した Web 参照を挿入するインデックス位置。

webReference

挿入する Web 参照。

解説

コレクション内で、index より大きいインデックスを持つメンバのインデックスは、それぞれ 1 だけ増やされます。インデックス番号は 0 から始まります。

使用例

Insert メソッドを使用するコード例を次に示します。

C#

using System;
using System.CodeDom;
using System.CodeDom.Compiler;
using System.Web.Services;
using System.Web.Services.Description;
using System.Web.Services.Discovery;
using System.Xml;
using System.Xml.Serialization;

public class Test
{
    public static void Main
 ()
    {
        // Read in a WSDL service description.
        string url = "http://www.contoso.com/Example/WebService.asmx?WSDL";
        XmlTextReader reader = new XmlTextReader(url);
        ServiceDescription wsdl = ServiceDescription.Read(reader);

        // Create a WSDL collection.
        DiscoveryClientDocumentCollection wsdlCollection = 
            new DiscoveryClientDocumentCollection();
        wsdlCollection.Add(url, wsdl);

        // Define the parameters needed to create web references.
        CodeNamespace proxyNamespace = new CodeNamespace("ExampleNamespace");
        string baseUrl = "http://www.contoso.com";
        string protocolName = "Soap12";

        // Create some web references.
        WebReference reference1 = new WebReference(
            wsdlCollection, proxyNamespace, protocolName, 
            "UrlKey1", baseUrl);
        WebReference reference2 = new WebReference(
            wsdlCollection, proxyNamespace, protocolName, 
            "UrlKey2", baseUrl);
        WebReference reference3 = new WebReference(
            wsdlCollection, proxyNamespace, protocolName, 
            "UrlKey3", baseUrl);

        // Create a web reference collection.
        WebReferenceCollection references = new WebReferenceCollection();
        references.Add(reference1);
        references.Add(reference2);

        // Confirm that the references were inserted.
        Console.WriteLine("The collection contains {0} references.", 
            references.Count);

        // Insert another reference into the collection.
        references.Insert(2, reference3);

        // Print the index of the inserted reference.
        int index = references.IndexOf(reference3);
        Console.WriteLine("The index of reference3 is {0}.", index);

        // Remove the inserted reference from the collection.
        references.Remove(reference3);

        // Determine if the collection contains reference3.
        if (references.Contains(reference3))
        {
            Console.WriteLine("The collection contains reference3.");
        }
        else 
        {
            Console.WriteLine("The collection does not contain reference3.");
        }

        // Print the URL key of the first reference in the collection.
        Console.WriteLine(
            "The URL key of the first reference in the collection
 is {0}.",
            references[0].AppSettingUrlKey);

        // Copy the collection to an array leaving the first array slot
 empty.
        WebReference[] referenceArray = new WebReference[3];
        references.CopyTo(referenceArray, 1);
        Console.WriteLine(
            "The URL key of the first reference in the array
 is {0}.",
            referenceArray[1].AppSettingUrlKey);
    }
}

J#

import System.*;
import System.CodeDom.*;
import System.CodeDom.Compiler.*;
import System.Web.Services.*;
import System.Web.Services.Description.*;
import System.Web.Services.Discovery.*;
import System.Xml.*;
import System.Xml.Serialization.*;

public class Test
{
    public static void main(String[]
 args)
    {
        // Read in a WSDL service description.
        String url = "http://www.contoso.com/Example/WebService.asmx?WSDL";
        XmlTextReader reader = new XmlTextReader(url);
        ServiceDescription wsdl = ServiceDescription.Read(reader);

        // Create a WSDL collection.
        DiscoveryClientDocumentCollection wsdlCollection = 
            new DiscoveryClientDocumentCollection();
        wsdlCollection.Add(url, wsdl);

        // Define the parameters needed to create web references.
        CodeNamespace proxyNamespace = new CodeNamespace("ExampleNamespace");
        String baseUrl = "http://www.contoso.com";
        String protocolName = "Soap12";

        // Create some web references.
        WebReference reference1 = new WebReference(wsdlCollection,
 
            proxyNamespace, protocolName, "UrlKey1", baseUrl);
        WebReference reference2 = new WebReference(wsdlCollection,
 
            proxyNamespace, protocolName, "UrlKey2", baseUrl);
        WebReference reference3 = new WebReference(wsdlCollection,
 
            proxyNamespace, protocolName, "UrlKey3", baseUrl);

        // Create a web reference collection.
        WebReferenceCollection references = new WebReferenceCollection();
        references.Add(reference1);
        references.Add(reference2);

        // Confirm that the references were inserted.
        Console.WriteLine("The collection contains {0} references.", 
            (Int32)references.get_Count());

        // Insert another reference into the collection.
        references.Insert(2, reference3);

        // Print the index of the inserted reference.
        int index = references.IndexOf(reference3);
        Console.WriteLine("The index of reference3 is {0}.", (Int32)index);

        // Remove the inserted reference from the collection.
        references.Remove(reference3);

        // Determine if the collection contains reference3.
        if (references.Contains(reference3)) {
            Console.WriteLine("The collection contains reference3.");
        }
        else {
            Console.WriteLine("The collection does not contain reference3.");
        }
        // Print the URL key of the first reference in the collection.
        Console.WriteLine("The URL key of the first reference in
 "
            + "the collection is {0}.", 
            references.get_Item(0).get_AppSettingUrlKey());

        // Copy the collection to an array leaving the first array slot
 empty.
        WebReference referenceArray[] = new WebReference[3];
        references.CopyTo(referenceArray, 1);
        Console.WriteLine("The URL key of the first reference in
 the"
            + " array is {0}.", 
            referenceArray[1].get_AppSettingUrlKey());
    } //main
} //Test

プラットフォーム

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

参照

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