WebClientProtocol Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Services.Protocols

Zestaw:: System.Web.Services.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa klasę bazową dla wszystkich serwerów proxy klienta usługi sieci Web XML utworzonych przy użyciu ASP.NET.

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

Dziedziczenie: Object

MarshalByRefObject

Component
WebClientProtocol

Pochodne: System.Web.Services.Protocols.HttpWebClientProtocol

Atrybuty: ComVisibleAttribute

Przykłady

Poniższy przykład to ASP.NET formularz internetowy, który wywołuje usługę sieci Web XML o nazwie Math. EnterBtn_Click W ramach funkcji formularz internetowy ustawia informacje o serwerze proxy i poświadczenia klienta w klasie serwera proxy przed wywołaniem zdalnej metody usługi sieci Web XML.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

<%@ 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>

Uwagi

Właściwości WebClientProtocol klasy służą do kontrolowania zachowania transportu używanego do przesyłania żądania i odpowiedzi usługi sieci Web XML. Właściwości w tej klasie są mapować na właściwości znajdujące się w elemecie WebRequest. Wystąpienia klas pochodnych z WebRequestklasy , takich jak HttpWebRequest, są używane jako mechanizm transportu dla usług sieci Web XML utworzonych przy użyciu ASP.NET.

Aby komunikować się z usługą sieci Web XML, należy utworzyć klasę serwera proxy wyprowadzającą się pośrednio lub bezpośrednio z WebClientProtocol usługi sieci Web XML, którą chcesz wywołać. Zamiast ręcznie tworzyć klasę serwera proxy, możesz użyć narzędzia Wsdl.exe, aby utworzyć klasę serwera proxy dla danego opisu usługi sieci Web XML. Ponieważ WebClientProtocol jest klasą bazową serwera proxy klienta, jej właściwości można znaleźć w klasach serwera proxy. Te właściwości są przydatne do kontrolowania zachowania żądania bazowego transportu. Na przykład użyj Credentials właściwości do wywoływania uwierzytelnionych usług sieci Web XML. WebClientProtocol Wiele właściwości służy do inicjowania obiektu używanego WebRequest do tworzenia żądania sieci Web.

Konstruktory

WebClientProtocol()

Inicjuje nowe wystąpienie klasy WebClientProtocol.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
ConnectionGroupName	Pobiera lub ustawia nazwę grupy połączeń dla żądania.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
Credentials	Pobiera lub ustawia poświadczenia zabezpieczeń dla uwierzytelniania klienta usługi sieci Web XML.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
PreAuthenticate	Pobiera lub ustawia, czy jest włączone wstępne uwierzytelnianie.
RequestEncoding	Element Encoding używany do żądania klienta do usługi sieci Web XML.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
Timeout	Wskazuje czas oczekiwania klienta usługi sieci Web XML na odebranie synchronicznego żądania usługi sieci Web XML (w milisekundach).
Url	Pobiera lub ustawia podstawowy adres URL usługi sieci Web XML, o który żąda klient.
UseDefaultCredentials	Pobiera lub ustawia wartość wskazującą, czy właściwość ma być ustawiona Credentials na wartość DefaultCredentials właściwości.

Metody

Abort()	Anuluje żądanie do metody usługi sieci Web XML.
AddToCache(Type, Object)	Dodaj wystąpienie programu obsługi protokołu klienta do pamięci podręcznej.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetFromCache(Type)	Pobiera wystąpienie programu obsługi protokołu klienta z pamięci podręcznej.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Nieaktualne. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetWebRequest(Uri)	Tworzy WebRequest wystąpienie dla określonego `uri`elementu . Ta chroniona metoda jest wywoływana przez infrastrukturę klienta usługi sieci Web XML w celu pobrania nowego WebRequest obiektu transportu w celu przesłania żądania usługi sieci Web XML.
GetWebResponse(WebRequest)	Zwraca odpowiedź z synchronicznego żądania do metody usługi sieci Web XML.
GetWebResponse(WebRequest, IAsyncResult)	Zwraca odpowiedź z asynchronicznego żądania do metody usługi sieci Web XML. Ta chroniona metoda jest wywoływana przez infrastrukturę klienta usługi sieci Web XML w celu uzyskania odpowiedzi z asynchronicznego żądania usługi sieci Web XML.
InitializeLifetimeService()	Nieaktualne. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Dotyczy

Bezpieczeństwo wątkowe

Właściwości tej klasy są kopiowane do nowego wystąpienia WebRequest obiektu dla każdego wywołania metody usługi sieci Web XML. Chociaż w tym samym czasie można wywoływać metody usługi sieci Web XML w tym samym WebClientProtocol wystąpieniu z różnych wątków, synchronizacja nie jest wykonywana w celu zapewnienia, że spójna migawka właściwości zostanie przeniesiona do WebRequest obiektu. W związku z tym, jeśli musisz zmodyfikować właściwości i wykonać współbieżne wywołania metody z różnych wątków, należy użyć innego wystąpienia serwera proxy usługi sieci Web XML lub zapewnić własną synchronizację.