WebReference 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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 物件。