HttpPostClientProtocol 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.

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: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol
HttpPostClientProtocol

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 usługa sieci Web XML, z której utworzono poprzednią klasę Math 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	Służy Encoding 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 odpowiedź na synchroniczne żądanie usługi sieci Web XML do odebrania (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, którego żą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()	Przestarzałe. 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 bieżące wystąpienie. (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()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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

Udostępnij za pośrednictwem