HttpSimpleClientProtocol Kelas

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.

Mewakili kelas dasar untuk berkomunikasi dengan layanan Web XML menggunakan pengikatan protokol HTTP-GET dan HTTP-POST sederhana.

public ref class HttpSimpleClientProtocol abstract : System::Web::Services::Protocols::HttpWebClientProtocol

public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol

type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol

[<System.Runtime.InteropServices.ComVisible(true)>]
type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol

Public MustInherit Class HttpSimpleClientProtocol
Inherits HttpWebClientProtocol

Warisan: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol
HttpSimpleClientProtocol

Turunan: System.Web.Services.Protocols.HttpGetClientProtocol

System.Web.Services.Protocols.HttpPostClientProtocol

Atribut: ComVisibleAttribute

Contoh

Contoh kode berikut adalah kelas proksi yang dihasilkan oleh Wsdl.exe untuk Math layanan Web XML di bawah ini. Kelas proksi berasal dari HttpGetClientProtocol, 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::HttpGetClientProtocol
{
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::UrlParameterWriter::typeid)]
   [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>",Namespace="http://www.contoso.com/",IsNullable=false)]
   int Add( String^ num1, String^ num2 )
   {
      array<Object^>^temp0 = {num1,num2};
      return  *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp0 ));
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState )
   {
      array<Object^>^temp1 = {num1,num2};
      return this->BeginInvoke( "Add", (String::Concat( this->Url, "/Add" )), temp1, 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.HttpGetClientProtocol {

    [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.UrlParameterWriter))]
    [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.HttpGetClientProtocol
    
    <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.UrlParameterWriter))>  _
    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 kode berikut adalah Math layanan Web XML, tempat kelas proksi sebelumnya dibuat.

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

using namespace System::Web::Services;
using namespace System;
public ref class Math
{
public:

   [WebMethod]
   int Add( int num1, int num2 )
   {
      return num1 + num2;
   }

};

using System.Web.Services;
using System;

public class Math
{
    [WebMethod]
    public int Add(int num1, int num2)
    {
        return num1 + num2;
    }
}

Imports System.Web.Services

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

Keterangan

Kelas ini menentukan sebagian besar implementasi untuk berkomunikasi dengan layanan Web XML melalui HTTP menggunakan encoder untuk mengodekan parameter dan mengembalikan nilai ke dalam format MIME umum. Encoder ini berasal dari MimeFormatter kelas . Secara default, kelas proksi yang berasal dari HttpSimpleClientProtocol parameter pengodean menggunakan jenis MIME yang dikodekan aplikasi/x-www-form-urlencoded dan respons dalam XML biasa. Formatter mime kustom dapat ditentukan menggunakan HttpMethodAttribute atribut , namun, tidak ada dukungan untuk mengintegrasikan ini ke dalam deskripsi layanan dan pembuatan proksi.

Notes to Inheritors: Saat Anda mengambil alih kelas ini, Anda dapat memperkenalkan metode di kelas turunan yang khusus untuk jenis layanan Web XML tertentu. Metode hanya menangkap parameter, dan memanggil kelas dasar untuk melakukan pekerjaan berkomunikasi dengan situs. Jika metode yang diperkenalkan asinkron, panggil BeginInvoke metode dan EndInvoke . Jika metode yang diperkenalkan sinkron, panggil Invoke metode . Konstruktor yang ditimpa Url biasanya mengatur properti ke URI metode layanan Web XML.

Alat Bahasa Deskripsi Layanan Web (Wsdl.exe) menghasilkan kelas turunan HttpSimpleClientProtocol untuk Deskripsi Layanan tertentu.

Konstruktor

Nama	Deskripsi
HttpSimpleClientProtocol()	Menginisialisasi instans baru dari kelas HttpSimpleClientProtocol.

Properti

Nama	Deskripsi
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 untuk 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

Nama	Deskripsi
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.
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 yang tidak dikelola 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.
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 Type instans saat ini. (Diperoleh dari Object)
GetWebRequest(Uri)	WebRequest Membuat untuk URI yang ditentukan. (Diperoleh dari HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Mengembalikan respons dari permintaan asinkron ke metode layanan Web XML. (Diperoleh dari HttpWebClientProtocol)
GetWebResponse(WebRequest)	Mengembalikan respons dari permintaan sinkron 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.
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Memanggil metode yang ditentukan secara asinkron sambil mempertahankan status terkait.
InvokeAsync(String, String, Object[], SendOrPostCallback)	Memanggil metode yang ditentukan secara asinkron.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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

Nama	Deskripsi
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)

Berlaku untuk

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

SoapHttpClientProtocol

Saran dan Komentar

Apakah halaman ini membantu?