WebReferenceCollection 類別

參考

定義

命名空間:: System.Web.Services.Description

組件:: System.Web.Services.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

描述 WebReference 物件的集合。

public ref class WebReferenceCollection sealed : System::Collections::CollectionBase

public sealed class WebReferenceCollection : System.Collections.CollectionBase

type WebReferenceCollection = class
    inherit CollectionBase

Public NotInheritable Class WebReferenceCollection
Inherits CollectionBase

繼承: Object

CollectionBase
WebReferenceCollection

範例

下列程式碼範例說明這個類別的使用。

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

class Test
{

    [SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
    static void Run(){

   // Get a WSDL file describing a service.
        ServiceDescription description = ServiceDescription.Read("DataTypes_CS.wsdl");

    // Initialize a service description importer.
    ServiceDescriptionImporter importer = new ServiceDescriptionImporter();
    importer.ProtocolName = "Soap12";  // Use SOAP 1.2.
    importer.AddServiceDescription(description,null,null);

    // Report on the service descriptions.
    Console.WriteLine("Importing {0} service descriptions with {1} associated schemas.",
                      importer.ServiceDescriptions.Count, importer.Schemas.Count);

    // Generate a proxy client.
    importer.Style = ServiceDescriptionImportStyle.Client;

    // Generate properties to represent primitive values.
    importer.CodeGenerationOptions = System.Xml.Serialization.CodeGenerationOptions.GenerateProperties;

    // Initialize a Code-DOM tree into which we will import the service.
    CodeNamespace nmspace = new CodeNamespace();
    CodeCompileUnit unit1 = new CodeCompileUnit();
    unit1.Namespaces.Add(nmspace);

    // Import the service into the Code-DOM tree. This creates proxy code
    // that uses the service.
    ServiceDescriptionImportWarnings warning = importer.Import(nmspace, unit1);

    if (warning == 0)
    {
        // Generate and print the proxy code in C#.
        CodeDomProvider provider1 = CodeDomProvider.CreateProvider("CSharp");
        provider1.GenerateCodeFromCompileUnit(unit1, Console.Out, new CodeGeneratorOptions());
    }
    else
    {
        // Print an error message.
        Console.WriteLine("Warning: " + warning); 
    }

        string url = "AddNumbers.wsdl";

        // Read in a WSDL service description.
        XmlTextReader reader = new XmlTextReader(url);
        ServiceDescription wsdl = ServiceDescription.Read(reader);

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

        // Create a namespace and a unit for compilation.
        CodeNamespace space = new CodeNamespace();
        CodeCompileUnit unit = new CodeCompileUnit();
        unit.Namespaces.Add(space);

        // Create a web referernce using the WSDL collection.
        WebReference reference = new WebReference(wsdlCollection, space);
        reference.ProtocolName = "Soap12";

        // Print some information about the web reference.
        Console.WriteLine("Base Url = {0}", reference.AppSettingBaseUrl);
        Console.WriteLine("Url Key = {0}", reference.AppSettingUrlKey);
        Console.WriteLine("Documents = {0}", reference.Documents.Count);

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

        // Compile a proxy client and print out the code. 
        CodeDomProvider provider = CodeDomProvider.CreateProvider("CSharp");
        WebReferenceOptions options = new WebReferenceOptions();
        options.Style = ServiceDescriptionImportStyle.Client;
        options.CodeGenerationOptions = CodeGenerationOptions.GenerateNewAsync;
        ServiceDescriptionImporter.GenerateWebReferences(
            references,
            provider,
            unit,
            options        
        );
        provider.GenerateCodeFromCompileUnit(unit, Console.Out, new CodeGeneratorOptions() );          
    }

    static void Main ()
    {

        Test.Run();
    }
}

備註

叫用類別的 WebReference ServiceDescriptionImporter 靜態 GenerateWebReferences 方法時，請使用這個類別來傳遞物件的集合。

建構函式

WebReferenceCollection()

初始化 WebReferenceCollection 類別的新執行個體。

屬性

Capacity	取得或設定 CollectionBase 可包含的項目數目。 (繼承來源 CollectionBase)
Count	取得 CollectionBase 執行個體中包含的元素數目。這個屬性無法覆寫。 (繼承來源 CollectionBase)
InnerList	取得包含 ArrayList 執行個體中之元素清單的 CollectionBase。 (繼承來源 CollectionBase)
Item[Int32]	取得或設定位於指定索引處的 WebReference 執行個體。
List	取得包含 IList 執行個體中之元素清單的 CollectionBase。 (繼承來源 CollectionBase)

方法

Add(WebReference)	將 WebReference 執行個體附加至集合。
Clear()	從 CollectionBase 執行個體移除所有的物件。無法覆寫這個方法。 (繼承來源 CollectionBase)
Contains(WebReference)	判斷集合是否包含指定的 WebReference 執行個體。
CopyTo(WebReference[], Int32)	從指定的陣列索引處開始，將集合的成員複製至指定的陣列。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回可逐一查看 CollectionBase 執行個體的列舉值。 (繼承來源 CollectionBase)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(WebReference)	判斷指定 WebReference 執行個體的索引。
Insert(Int32, WebReference)	在指定索引處插入指定的 WebReference 執行個體。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnClear()	在清除 CollectionBase 執行個體的內容之後，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnClearComplete()	在清除 CollectionBase 執行個體的內容後，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnInsert(Int32, Object)	在將新的元素插入至 CollectionBase 執行個體前，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnInsertComplete(Int32, Object)	在將新的元素插入至 CollectionBase 執行個體後，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnRemove(Int32, Object)	當從 CollectionBase 執行個體移除元素時，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnRemoveComplete(Int32, Object)	在從 CollectionBase 執行個體移除元素後，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnSet(Int32, Object, Object)	在 CollectionBase 執行個體中設定數值前，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnSetComplete(Int32, Object, Object)	在 CollectionBase 執行個體中設定數值後，執行額外的自訂處理序。 (繼承來源 CollectionBase)
OnValidate(Object)	當驗證數值時，執行額外的自訂處理序。 (繼承來源 CollectionBase)
Remove(WebReference)	移除集合中的指定 WebReference 執行個體。
RemoveAt(Int32)	移除 CollectionBase 執行個體之指定索引的元素。這個方法不可覆寫。 (繼承來源 CollectionBase)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

ICollection.CopyTo(Array, Int32)	從目標陣列的指定索引開始，將整個 CollectionBase 複製到相容的一維 Array。 (繼承來源 CollectionBase)
ICollection.IsSynchronized	取得值，這個值表示對 CollectionBase 的存取是否同步 (安全執行緒)。 (繼承來源 CollectionBase)
ICollection.SyncRoot	取得可用以同步存取 CollectionBase 的物件。 (繼承來源 CollectionBase)
IList.Add(Object)	將物件加入至 CollectionBase 的末端。 (繼承來源 CollectionBase)
IList.Contains(Object)	判斷 CollectionBase 是否包含特定項目。 (繼承來源 CollectionBase)
IList.IndexOf(Object)	搜尋指定的 Object，並傳回在整個 CollectionBase 中第一個符合項目之以零為起始的索引。 (繼承來源 CollectionBase)
IList.Insert(Int32, Object)	將項目插入至 CollectionBase 中指定的索引位置。 (繼承來源 CollectionBase)
IList.IsFixedSize	取得值，指出 CollectionBase 是否有固定的大小。 (繼承來源 CollectionBase)
IList.IsReadOnly	取得值，指出 CollectionBase 是否唯讀。 (繼承來源 CollectionBase)
IList.Item[Int32]	在指定的索引位置上取得或設定項目。 (繼承來源 CollectionBase)
IList.Remove(Object)	從 CollectionBase 移除特定物件之第一個符合的元素。 (繼承來源 CollectionBase)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

適用於

WebReferenceCollection 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

擴充方法

適用於

意見反應

其他資源