共用方式為

WebClientProtocol 類別

  • 參考

定義

命名空間:
System.Web.Services.Protocols
組件:
System.Web.Services.dll

指定使用 ASP.NET 建立之所有 XML Web 服務用戶端 Proxy 的基類。

public ref class WebClientProtocol abstract : System::ComponentModel::Component
public abstract class WebClientProtocol : System.ComponentModel.Component
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class WebClientProtocol : System.ComponentModel.Component
type WebClientProtocol = class
    inherit Component
[<System.Runtime.InteropServices.ComVisible(true)>]
type WebClientProtocol = class
    inherit Component
Public MustInherit Class WebClientProtocol
Inherits Component
繼承
Object
MarshalByRefObject
Component
WebClientProtocol
衍生
屬性
ComVisibleAttribute

範例

下列範例是 ASP.NET Web Form，它會呼叫名為 Math的 XML Web 服務。 在 EnterBtn_Click 函式中，Web Form 會在呼叫遠端 XML Web 服務方法之前，先在 Proxy 類別上設定 Proxy 資訊和客戶端認證。

重要

此範例有一個文本框，可接受用戶輸入，這是潛在的安全性威脅。 根據預設，ASP.NET 網頁會驗證使用者輸入不包含腳本或 HTML 元素。 如需詳細資訊，請參閱 文稿惡意探索概觀。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>
<html>
    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
          {
             MyMath.Math math = new MyMath.Math();

             // Set the client-side credentials using the Credentials property.
             ICredentials credentials = new NetworkCredential("Joe","mydomain","password");
             math.Credentials = credentials;
             
             // Do not allow the server to redirect the request.
             math.AllowAutoRedirect = false;
             
             int total = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text));
             Total.Text = "Total: " + total.ToString();
         }
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Net" %>
<html>
    <script language="VB" runat="server">
    
        Sub EnterBtn_Click(src As Object, e As EventArgs)
            Dim math As New MyMath.Math()
            
            ' Set the client-side credentials using the Credentials property.
            Dim credentials As New NetworkCredential("Joe", "password", "mydomain")
            math.Credentials = credentials
            
            ' Do not allow the server to redirect the request.
            math.AllowAutoRedirect = False
            
            Dim iTotal As Integer = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text))
            Total.Text = "Total: " & iTotal.ToString()
        End Sub
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>

備註

WebClientProtocol 類別的屬性可用來控制傳輸 XML Web 服務要求和回應所使用的傳輸行為。 此類別上的屬性會對應至 WebRequest上找到的屬性。 衍生自 WebRequest的類別實例，例如 HttpWebRequest，會作為使用 ASP.NET 建立之 XML Web 服務的傳輸機制。

若要與 XML Web 服務通訊，您必須針對您想要呼叫的 XML Web 服務，建立間接或直接從 WebClientProtocol 衍生的 Proxy 類別。 您可以使用 Wsdl.exe 工具來為指定的 XML Web 服務描述建立 Proxy 類別，而不是手動建立 Proxy 類別。 由於 WebClientProtocol 是用戶端 Proxy 的基類，因此您會在 Proxy 類別上找到其屬性。 這些屬性適用於控制基礎傳輸的要求行為。 例如，使用 Credentials 屬性來呼叫已驗證的 XML Web 服務。 許多 WebClientProtocol 屬性都用來初始化用來提出 Web 要求的 WebRequest 物件。

建構函式

WebClientProtocol()

初始化 WebClientProtocol 類別的新實例。

屬性

CanRaiseEvents

取得值，指出元件是否可以引發事件。

(繼承來源 Component)
ConnectionGroupName

取得或設定要求的連接組名。
Container

取得包含 Component的 IContainer。

(繼承來源 Component)
Credentials

取得或設定 XML Web 服務客戶端驗證的安全性認證。
DesignMode

取得值，這個值表示 Component 目前是否處於設計模式。

(繼承來源 Component)
Events

取得附加至這個 Component之事件處理程序的清單。

(繼承來源 Component)
PreAuthenticate

取得或設定是否啟用預先驗證。
RequestEncoding

用來向 XML Web 服務提出用戶端要求 Encoding。
Site

取得或設定 Component的 ISite。

(繼承來源 Component)
Timeout

表示 XML Web 服務用戶端等候回復至同步 XML Web 服務要求的時間（以毫秒為單位）。
Url

取得或設定用戶端要求之 XML Web 服務的基底 URL。
UseDefaultCredentials

取得或設定值，這個值表示是否要將 Credentials 屬性設定為 DefaultCredentials 屬性的值。

方法

Abort()

取消對 XML Web 服務方法的要求。
AddToCache(Type, Object)

將用戶端通訊協議處理程序的實例新增至快取。
CreateObjRef(Type)

建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。

(繼承來源 MarshalByRefObject)
Dispose()

釋放 Component所使用的所有資源。

(繼承來源 Component)
Dispose(Boolean)

釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。

(繼承來源 Component)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetFromCache(Type)

從快取取得用戶端通訊協議處理程序的實例。
GetHashCode()

做為預設哈希函式。

(繼承來源 Object)
GetLifetimeService()
已淘汰.

擷取控制這個實例存留期原則的目前存留期服務物件。

(繼承來源 MarshalByRefObject)
GetService(Type)

傳回 物件，表示 Component 或其 Container所提供的服務。

(繼承來源 Component)
GetType()

取得目前實例的 Type。

(繼承來源 Object)
GetWebRequest(Uri)

為指定的 uri建立 WebRequest 實例。 XML Web 服務用戶端基礎結構會呼叫這個受保護的方法，以取得新的 WebRequest 傳輸物件，以傳輸 XML Web 服務要求。
GetWebResponse(WebRequest, IAsyncResult)

從異步要求傳回 XML Web 服務方法的回應。 XML Web 服務用戶端基礎結構會呼叫這個受保護的方法，以從異步 XML Web 服務要求取得回應。
GetWebResponse(WebRequest)

從同步要求傳回 XML Web 服務方法的回應。
InitializeLifetimeService()
已淘汰.

取得存留期服務物件，以控制這個實例的存留期原則。

(繼承來源 MarshalByRefObject)
MemberwiseClone()

建立目前 Object的淺層複本。

(繼承來源 Object)
MemberwiseClone(Boolean)

建立目前 MarshalByRefObject 對象的淺層複本。

(繼承來源 MarshalByRefObject)
ToString()

傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。

(繼承來源 Component)

事件

Disposed

當呼叫 Dispose() 方法時，就會發生元件。

(繼承來源 Component)

適用於

執行緒安全性

這個類別上的屬性會複製到每個 XML Web 服務方法呼叫之 WebRequest 物件的新實例中。 雖然您可以在相同 WebClientProtocol 實例上同時從不同線程呼叫 XML Web 服務方法，但不會進行同步處理，以確保屬性的一致快照集會傳送至 WebRequest 物件。 因此，如果您需要修改屬性，並從不同的線程進行並行方法呼叫，您應該使用不同的 XML Web 服務 Proxy 實例，或提供您自己的同步處理。

另請參閱