WebReference 建構函式

定義

命名空間:

System.Web.Services.Description

組件:

System.Web.Services.dll

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

多載

WebReference(DiscoveryClientDocumentCollection, CodeNamespace)	使用指定的描述文件集合和 Proxy 程式碼命名空間，初始化 WebReference 類別的新執行個體。
WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String)	使用指定的資料，初始化 WebReference 類別的新執行個體。
WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String, String)	使用指定的資料，初始化 WebReference 類別的新執行個體。

WebReference(DiscoveryClientDocumentCollection, CodeNamespace)

使用指定的描述文件集合和 Proxy 程式碼命名空間，初始化 WebReference 類別的新執行個體。

public:
 WebReference(System::Web::Services::Discovery::DiscoveryClientDocumentCollection ^ documents, System::CodeDom::CodeNamespace ^ proxyCode);

public WebReference (System.Web.Services.Discovery.DiscoveryClientDocumentCollection documents, System.CodeDom.CodeNamespace proxyCode);

new System.Web.Services.Description.WebReference : System.Web.Services.Discovery.DiscoveryClientDocumentCollection * System.CodeDom.CodeNamespace -> System.Web.Services.Description.WebReference

Public Sub New (documents As DiscoveryClientDocumentCollection, proxyCode As CodeNamespace)

參數

documents

DiscoveryClientDocumentCollection

指定描述文件集合的 DiscoveryClientDocumentCollection。

proxyCode

CodeNamespace

CodeNamespace，指定程式碼編譯的命名空間。

範例

下列程式碼範例說明此建構函式的使用方式。 此程式碼範例是針對 類別提供的較大範例的 WebReference 一部分。

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

備註

集合 documents 應該只 ServiceDescription 包含 和 XmlSchema 物件; GenerateWebReferences 方法無法解譯 DiscoveryDocument 物件。

WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String)

使用指定的資料，初始化 WebReference 類別的新執行個體。

public:
 WebReference(System::Web::Services::Discovery::DiscoveryClientDocumentCollection ^ documents, System::CodeDom::CodeNamespace ^ proxyCode, System::String ^ appSettingUrlKey, System::String ^ appSettingBaseUrl);

public WebReference (System.Web.Services.Discovery.DiscoveryClientDocumentCollection documents, System.CodeDom.CodeNamespace proxyCode, string appSettingUrlKey, string appSettingBaseUrl);

new System.Web.Services.Description.WebReference : System.Web.Services.Discovery.DiscoveryClientDocumentCollection * System.CodeDom.CodeNamespace * string * string -> System.Web.Services.Description.WebReference

Public Sub New (documents As DiscoveryClientDocumentCollection, proxyCode As CodeNamespace, appSettingUrlKey As String, appSettingBaseUrl As String)

參數

documents

DiscoveryClientDocumentCollection

指定描述文件集合的 DiscoveryClientDocumentCollection。

proxyCode

CodeNamespace

CodeNamespace，指定程式碼編譯的命名空間。

appSettingUrlKey

String

Web 參考的 URL 索引鍵。

appSettingBaseUrl

String

Web 參考的基礎 URL。

備註

集合 documents 應該只 ServiceDescription 包含 和 XmlSchema 物件; GenerateWebReferences 方法無法解譯 DiscoveryDocument 物件。

WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String, String)

使用指定的資料，初始化 WebReference 類別的新執行個體。

public:
 WebReference(System::Web::Services::Discovery::DiscoveryClientDocumentCollection ^ documents, System::CodeDom::CodeNamespace ^ proxyCode, System::String ^ protocolName, System::String ^ appSettingUrlKey, System::String ^ appSettingBaseUrl);

public WebReference (System.Web.Services.Discovery.DiscoveryClientDocumentCollection documents, System.CodeDom.CodeNamespace proxyCode, string protocolName, string appSettingUrlKey, string appSettingBaseUrl);

new System.Web.Services.Description.WebReference : System.Web.Services.Discovery.DiscoveryClientDocumentCollection * System.CodeDom.CodeNamespace * string * string * string -> System.Web.Services.Description.WebReference

Public Sub New (documents As DiscoveryClientDocumentCollection, proxyCode As CodeNamespace, protocolName As String, appSettingUrlKey As String, appSettingBaseUrl As String)

參數

documents

DiscoveryClientDocumentCollection

指定描述文件集合的 DiscoveryClientDocumentCollection。

proxyCode

CodeNamespace

CodeNamespace，指定程式碼編譯的命名空間。

protocolName

String

XML Web Service 使用的通訊協定 (Protocol)。

appSettingUrlKey

String

Web 參考的 URL 索引鍵。

appSettingBaseUrl

String

Web 參考的基礎 URL。

範例

下列程式碼範例示範如何使用這個建構函式。

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

// Create a namespace.
CodeNamespace proxyNamespace = new CodeNamespace("ExampleNamespace");

// Create a web reference using the WSDL collection.
string baseUrl = "http://www.contoso.com";
string urlKey = "ExampleUrlKey";
string protocolName = "Soap12";
WebReference reference = new WebReference(
    wsdlCollection, proxyNamespace, protocolName, urlKey, baseUrl);

// Print some information about the web reference.
Console.WriteLine("The WebReference object contains {0} document(s).", 
    reference.Documents.Count);
Console.WriteLine("The protocol name is {0}.", reference.ProtocolName);
Console.WriteLine("The base URL is {0}.", reference.AppSettingBaseUrl);
Console.WriteLine("The URL key is {0}.", reference.AppSettingUrlKey);

// Print some information about the proxy code namespace.
Console.WriteLine("The proxy code namespace is {0}.", 
    reference.ProxyCode.Name);

// Print some information about the validation warnings.
Console.WriteLine("There are {0} validation warnings.",
    reference.ValidationWarnings.Count);

// Print some information about the warnings.
if (reference.Warnings == 0)
{
    Console.WriteLine("There are no warnings.");
}
else
{
    Console.WriteLine("Warnings: " + reference.Warnings);
}

備註

集合 documents 應該只 ServiceDescription 包含 和 XmlSchema 物件; GenerateWebReferences 方法無法解譯 DiscoveryDocument 物件。