HttpPostClientProtocol Klasa

Definicja

Klasa bazowa dla serwerów proxy klienta usługi sieci Web XML korzystających z protokołu HTTP-POST.

public ref class HttpPostClientProtocol : System::Web::Services::Protocols::HttpSimpleClientProtocol
public class HttpPostClientProtocol : System.Web.Services.Protocols.HttpSimpleClientProtocol
type HttpPostClientProtocol = class
    inherit HttpSimpleClientProtocol
Public Class HttpPostClientProtocol
Inherits HttpSimpleClientProtocol
Dziedziczenie

Przykłady

Poniższy przykład to klasa serwera proxy wygenerowana przez narzędzie Wsdl.exe dla Math usługi sieci Web XML poniżej. Klasa serwera proxy pochodzi z HttpPostClientProtocolklasy , która pochodzi z klasy abstrakcyjnej HttpSimpleClientProtocol .

#using <System.Web.Services.dll>
#using <System.Xml.dll>
#using <System.dll>

using namespace System::Diagnostics;
using namespace System::Xml::Serialization;
using namespace System;
using namespace System::Web::Services::Protocols;
using namespace System::Web::Services;

public ref class MyMath: public System::Web::Services::Protocols::HttpPostClientProtocol
{
public:

   [System::Diagnostics::DebuggerStepThroughAttribute]
   MyMath()
   {
      this->Url = "http://www.contoso.com/math.asmx";
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   [System::Web::Services::Protocols::HttpMethodAttribute(System::Web::Services::Protocols::XmlReturnReader::typeid,
   System::Web::Services::Protocols::HtmlFormParameterWriter::typeid)]
   [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>",Namespace="http://www.contoso.com/",IsNullable=false)]
   int Add( String^ num1, String^ num2 )
   {
      array<Object^>^temp2 = {num1,num2};
      return  *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp2 ));
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState )
   {
      array<Object^>^temp3 = {num1,num2};
      return this->BeginInvoke( "Add", (this->Url + "/Add" ), temp3, callback, asyncState );
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   int EndAdd( System::IAsyncResult^ asyncResult )
   {
      return  *dynamic_cast<int^>(this->EndInvoke( asyncResult ));
   }
};
using System.Diagnostics;
using System.Xml.Serialization;
using System;
using System.Web.Services.Protocols;
using System.Web.Services;

public class MyMath : System.Web.Services.Protocols.HttpPostClientProtocol
{
    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public MyMath()
    {
        this.Url = "http://www.contoso.com/math.asmx";
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.Web.Services.Protocols.HttpMethodAttribute(typeof(System.Web.Services.Protocols.XmlReturnReader), typeof(System.Web.Services.Protocols.HtmlFormParameterWriter))]
    [return: System.Xml.Serialization.XmlRootAttribute("int", Namespace = "http://www.contoso.com/", IsNullable = false)]
    public int Add(string num1, string num2)
    {
        return ((int)(this.Invoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 })));
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public System.IAsyncResult BeginAdd(string num1, string num2, System.AsyncCallback callback, object asyncState)
    {
        return this.BeginInvoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 }, callback, asyncState);
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public int EndAdd(System.IAsyncResult asyncResult)
    {
        return ((int)(this.EndInvoke(asyncResult)));
    }
}
Option Strict On
Option Explicit On

Imports System.Diagnostics
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization

Public Class MyMath
    Inherits System.Web.Services.Protocols.HttpPostClientProtocol
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Sub New()
        MyBase.New
        Me.Url = "http://www.contoso.com/math.asmx"
    End Sub
    
    <System.Diagnostics.DebuggerStepThroughAttribute(),  _
     System.Web.Services.Protocols.HttpMethodAttribute(GetType(System.Web.Services.Protocols.XmlReturnReader), GetType(System.Web.Services.Protocols.HtmlFormParameterWriter))>  _
    Public Function Add(ByVal num1 As String, ByVal num2 As String) As <System.Xml.Serialization.XmlRootAttribute("int", [Namespace]:="http://www.contoso.com/", IsNullable:=false)> Integer
        Return CType(Me.Invoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}),Integer)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function BeginAdd(ByVal num1 As String, ByVal num2 As String, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult
        Return Me.BeginInvoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}, callback, asyncState)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer
        Return CType(Me.EndInvoke(asyncResult),Integer)
    End Function
End Class

Poniższy przykład to Math usługa sieci Web XML, z której utworzono poprzednią klasę serwera proxy.

<%@ WebService Language="C#" Class="Math"%>
 using System.Web.Services;
 using System;
 
 public class Math {
      [ WebMethod ]
      public int Add(int num1, int num2) {
          return num1+num2;
          }
 }
<%@ WebService Language="VB" Class="Math"%>
Imports System.Web.Services
Imports System

Public Class Math
    <WebMethod()> _
    Public Function Add(num1 As Integer, num2 As Integer) As Integer
        Return num1 + num2
    End Function 'Add
End Class 'Math

Uwagi

Gdy klient usługi sieci Web XML używa protokołu HTTP-POST, domyślnie parametry są kodowane w treści HTTP przy użyciu reguł kodowania adresów URL i używają zwykłego kodu XML dla odpowiedzi. Ten protokół używa klas, które pochodzą z MimeFormatter , aby kodować parametry i zwracać wartości do standardowych formatów MIME. Kodery do użycia są określone w opisie usługi.

Jeśli tworzysz klienta usługi sieci Web XML przy użyciu ASP.NET, należy utworzyć klasę serwera proxy wyprowadzającą pośrednio lub bezpośrednio z WebClientProtocol usługi sieci Web XML, którą chcesz wywołać. Gdy klient usługi sieci Web XML wywołuje wywołanie przy użyciu protokołu HTTP, należy utworzyć klasę HttpSimpleClientProtocolserwera proxy, która z kolei pochodzi z WebClientProtocolklasy .

HttpGetClientProtocol i HttpPostClientProtocol pochodzą z HttpSimpleClientProtocolmetody , zapewniając obsługę wywoływania metody usługi sieci Web XML przy użyciu odpowiednio HTTP-GET i HTTP-POST. Klienci wywołujący usługę sieci Web XML przy użyciu protokołu SOAP powinni pochodzić z SoapHttpClientProtocolklasy .

Aby uzyskać szczegółowe informacje na temat tworzenia klasy serwera proxy, zobacz Tworzenie serwera proxy usługi sieci Web XML.

Konstruktory

HttpPostClientProtocol()

Inicjuje nowe wystąpienie klasy HttpPostClientProtocol.

Właściwości

AllowAutoRedirect

Pobiera lub ustawia, czy klient automatycznie śledzi przekierowania serwera.

(Odziedziczone po HttpWebClientProtocol)
CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
ClientCertificates

Pobiera kolekcję certyfikatów klienta.

(Odziedziczone po HttpWebClientProtocol)
ConnectionGroupName

Pobiera lub ustawia nazwę grupy połączeń dla żądania.

(Odziedziczone po WebClientProtocol)
Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
CookieContainer

Pobiera lub ustawia kolekcję plików cookie.

(Odziedziczone po HttpWebClientProtocol)
Credentials

Pobiera lub ustawia poświadczenia zabezpieczeń dla uwierzytelniania klienta usługi sieci Web XML.

(Odziedziczone po WebClientProtocol)
DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
EnableDecompression

Pobiera lub ustawia wartość wskazującą, czy dekompresja jest włączona dla tego elementu HttpWebClientProtocol.

(Odziedziczone po HttpWebClientProtocol)
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.

(Odziedziczone po WebClientProtocol)
Proxy

Pobiera lub ustawia informacje o serwerze proxy na potrzeby tworzenia żądania usługi sieci Web XML za pośrednictwem zapory.

(Odziedziczone po HttpWebClientProtocol)
RequestEncoding

Element Encoding używany do żądania klienta do usługi sieci Web XML.

(Odziedziczone po WebClientProtocol)
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).

(Odziedziczone po WebClientProtocol)
UnsafeAuthenticatedConnectionSharing

Pobiera lub ustawia wartość wskazującą, czy udostępnianie połączeń jest włączone, gdy klient używa uwierzytelniania NTLM w celu nawiązania połączenia z serwerem sieci Web hostujących usługę sieci Web XML.

(Odziedziczone po HttpWebClientProtocol)
Url

Pobiera lub ustawia podstawowy adres URL usługi sieci Web XML, o który żąda klient.

(Odziedziczone po WebClientProtocol)
UseDefaultCredentials

Pobiera lub ustawia wartość wskazującą, czy właściwość ma być ustawiona Credentials na wartość DefaultCredentials właściwości.

(Odziedziczone po WebClientProtocol)
UserAgent

Pobiera lub ustawia wartość nagłówka agenta użytkownika, który jest wysyłany z każdym żądaniem.

(Odziedziczone po HttpWebClientProtocol)

Metody

Abort()

Anuluje żądanie do metody usługi sieci Web XML.

(Odziedziczone po WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)

Uruchamia asynchroniczne wywołanie metody usługi sieci Web XML.

(Odziedziczone po HttpSimpleClientProtocol)
CancelAsync(Object)

Anuluje asynchroniczne wywołanie metody usługi sieci Web XML, chyba że wywołanie zostało już ukończone.

(Odziedziczone po HttpWebClientProtocol)
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)
EndInvoke(IAsyncResult)

Kończy asynchroniczne wywołanie metody usługi sieci Web XML przy użyciu protokołu HTTP.

(Odziedziczone po HttpSimpleClientProtocol)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
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)

WebRequest Tworzy wystąpienie dla określonego identyfikatora URI.

GetWebResponse(WebRequest)

Zwraca odpowiedź z synchronicznego żądania do metody usługi sieci Web XML.

(Odziedziczone po HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)

Zwraca odpowiedź z asynchronicznego żądania do metody usługi sieci Web XML.

(Odziedziczone po HttpWebClientProtocol)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
Invoke(String, String, Object[])

Wywołuje metodę usługi sieci Web XML przy użyciu protokołu HTTP.

(Odziedziczone po HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback)

Wywołuje określoną metodę asynchronicznie.

(Odziedziczone po HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)

Wywołuje określoną metodę asynchronicznie przy zachowaniu skojarzonego stanu.

(Odziedziczone po HttpSimpleClientProtocol)
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

Zobacz też