HttpPostClientProtocol Kelas

Referensi

Definisi

Ruang nama:: System.Web.Services.Protocols

Rakitan:: System.Web.Services.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Kelas dasar untuk proksi klien layanan Web XML yang menggunakan protokol 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

Warisan: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol
HttpPostClientProtocol

Contoh

Contoh berikut adalah kelas proksi yang dihasilkan oleh utilitas Wsdl.exe untuk Math layanan Web XML di bawah ini. Kelas proksi berasal dari HttpPostClientProtocol, yang berasal dari kelas abstrak 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

Contoh berikut adalah Math layanan Web XML, tempat kelas proksi sebelumnya dibuat.

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

Keterangan

Ketika klien layanan Web XML menggunakan protokol HTTP-POST, secara default parameter dikodekan dalam isi HTTP menggunakan aturan pengodean URL dan menggunakan XML biasa untuk respons. Protokol ini menggunakan kelas yang berasal dari MimeFormatter untuk mengodekan parameter dan mengembalikan nilai ke dalam format MIME standar. Encoder yang akan digunakan ditentukan dalam deskripsi layanan.

Jika Anda membangun klien layanan Web XML menggunakan ASP.NET, maka kelas proksi yang turun secara tidak langsung atau langsung dari WebClientProtocol perlu dibuat untuk layanan Web XML yang ingin Anda panggil. Ketika klien layanan Web XML memanggil menggunakan HTTP, dapatkan kelas HttpSimpleClientProtocolproksi , yang pada gilirannya berasal dari WebClientProtocol.

HttpGetClientProtocol dan HttpPostClientProtocol berasal dari HttpSimpleClientProtocol, memberikan dukungan untuk memanggil metode layanan Web XML menggunakan HTTP-GET dan HTTP-POST masing-masing. Klien yang memanggil layanan Web XML menggunakan SOAP harus berasal dari SoapHttpClientProtocol.

Untuk detail tentang membangun kelas proksi, lihat Membuat Proksi Layanan Web XML.

Konstruktor

HttpPostClientProtocol()

Menginisialisasi instans baru kelas HttpPostClientProtocol.

Properti

AllowAutoRedirect	Mendapatkan atau mengatur apakah klien secara otomatis mengikuti pengalihan server. (Diperoleh dari HttpWebClientProtocol)
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
ClientCertificates	Mendapatkan koleksi sertifikat klien. (Diperoleh dari HttpWebClientProtocol)
ConnectionGroupName	Mendapatkan atau mengatur nama grup koneksi untuk permintaan tersebut. (Diperoleh dari WebClientProtocol)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
CookieContainer	Mendapatkan atau mengatur koleksi cookie. (Diperoleh dari HttpWebClientProtocol)
Credentials	Mendapatkan atau mengatur kredensial keamanan untuk autentikasi klien layanan Web XML. (Diperoleh dari WebClientProtocol)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
EnableDecompression	Mendapatkan atau menetapkan nilai yang menunjukkan apakah dekompresi diaktifkan untuk ini HttpWebClientProtocol. (Diperoleh dari HttpWebClientProtocol)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
PreAuthenticate	Mendapatkan atau mengatur apakah pra-autentikasi diaktifkan. (Diperoleh dari WebClientProtocol)
Proxy	Mendapatkan atau mengatur informasi proksi untuk membuat permintaan layanan Web XML melalui firewall. (Diperoleh dari HttpWebClientProtocol)
RequestEncoding	yang Encoding digunakan untuk membuat permintaan klien ke layanan Web XML. (Diperoleh dari WebClientProtocol)
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Timeout	Menunjukkan waktu klien layanan Web XML menunggu balasan permintaan layanan Web XML sinkron tiba (dalam milidetik). (Diperoleh dari WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	Mendapatkan atau menetapkan nilai yang menunjukkan apakah berbagi koneksi diaktifkan saat klien menggunakan autentikasi NTLM untuk menyambungkan ke server Web yang menghosting layanan Web XML. (Diperoleh dari HttpWebClientProtocol)
Url	Mendapatkan atau mengatur URL dasar layanan Web XML yang diminta klien. (Diperoleh dari WebClientProtocol)
UseDefaultCredentials	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengatur Credentials properti ke nilai DefaultCredentials properti. (Diperoleh dari WebClientProtocol)
UserAgent	Mendapatkan atau menetapkan nilai untuk header agen pengguna yang dikirim dengan setiap permintaan. (Diperoleh dari HttpWebClientProtocol)

Metode

Abort()	Membatalkan permintaan ke metode layanan Web XML. (Diperoleh dari WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	Memulai pemanggilan asinkron dari metode layanan Web XML. (Diperoleh dari HttpSimpleClientProtocol)
CancelAsync(Object)	Membatalkan panggilan asinkron ke metode layanan Web XML, kecuali panggilan telah selesai. (Diperoleh dari HttpWebClientProtocol)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
EndInvoke(IAsyncResult)	Menyelesaikan pemanggilan asinkron metode layanan Web XML menggunakan HTTP. (Diperoleh dari HttpSimpleClientProtocol)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetWebRequest(Uri)	Membuat instans WebRequest untuk URI yang ditentukan.
GetWebResponse(WebRequest)	Mengembalikan respons dari permintaan sinkron ke metode layanan Web XML. (Diperoleh dari HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Mengembalikan respons dari permintaan asinkron ke metode layanan Web XML. (Diperoleh dari HttpWebClientProtocol)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Invoke(String, String, Object[])	Memanggil metode layanan Web XML menggunakan HTTP. (Diperoleh dari HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback)	Memanggil metode yang ditentukan secara asinkron. (Diperoleh dari HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Memanggil metode yang ditentukan secara asinkron sambil mempertahankan status terkait. (Diperoleh dari HttpSimpleClientProtocol)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode .

(Diperoleh dari Component)

Berlaku untuk

Bagikan melalui