HttpSimpleClientProtocol Sınıf

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

Basit HTTP-GET ve HTTP-POST protokol bağlamalarını kullanarak XML Web hizmetiyle iletişim kurmak için temel sınıfı temsil eder.

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

Devralma

Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol

Türetilmiş

System.Web.Services.Protocols.HttpGetClientProtocol

System.Web.Services.Protocols.HttpPostClientProtocol

Öznitelikler

ComVisibleAttribute

Örnekler

Aşağıdaki kod örneği, aşağıdaki XML Web hizmeti için Math Wsdl.exe tarafından oluşturulan bir proxy sınıfıdır. Proxy sınıfı, soyut HttpSimpleClientProtocol sınıfından HttpGetClientProtocoltüretilen öğesinden türetilir.

#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

Aşağıdaki kod örneği, önceki ara sunucu sınıfının oluşturulduğu XML Web hizmetidir Math .

#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

Açıklamalar

Bu sınıf, parametreleri kodlamak ve değerleri ortak MIME biçimlerine döndürmek için kodlayıcıları kullanarak HTTP üzerinden XML Web hizmetiyle iletişim kurmak için uygulamanın çoğunu belirtir. Bu kodlayıcılar sınıfından MimeFormatter türetilir. Varsayılan olarak, encodes sınıfından HttpSimpleClientProtocol türetilen bir proxy sınıfı, application/x-www-form-urlencoded MIME türünü ve yanıtı düz XML olarak kullanarak parametreleri kodlar. Özel mime biçimlendiricileri özniteliği kullanılarak HttpMethodAttribute belirtilebilir, ancak bunu bir hizmet açıklaması ve ara sunucu oluşturma ile tümleştirme desteği yoktur.

Notes to Inheritors: Bu sınıfı geçersiz kıldığınızda, türetilmiş sınıfta belirli bir XML Web hizmeti türüne özgü yöntemler ekleyebilirsiniz. Yöntemler yalnızca parametreleri yakalar ve siteyle iletişim kurma işini yapmak için temel sınıfı çağırır. Tanıtılan yöntemler zaman uyumsuzsa ve EndInvoke yöntemlerini çağırınBeginInvoke. Tanıtılan yöntemler zaman uyumluysa yöntemini çağırın Invoke . Geçersiz kılınan oluşturucu genellikle özelliği XML Web hizmeti yönteminin URI'sine ayarlar Url .

Web Hizmetleri Açıklama Dili aracı (Wsdl.exe), belirli bir Hizmet Açıklaması için türetilmiş sınıfları HttpSimpleClientProtocol oluşturur.

Oluşturucular

HttpSimpleClientProtocol()

HttpSimpleClientProtocol sınıfının yeni bir örneğini başlatır.

Özellikler

AllowAutoRedirect	İstemcinin sunucu yeniden yönlendirmelerini otomatik olarak takip edip etmediğini alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)
CanRaiseEvents	Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
ClientCertificates	İstemci sertifikaları koleksiyonunu alır. (Devralındığı yer: HttpWebClientProtocol)
ConnectionGroupName	İstek için bağlantı grubunun adını alır veya ayarlar. (Devralındığı yer: WebClientProtocol)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
CookieContainer	Tanımlama bilgileri koleksiyonunu alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)
Credentials	XML Web hizmeti istemci kimlik doğrulaması için güvenlik kimlik bilgilerini alır veya ayarlar. (Devralındığı yer: WebClientProtocol)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
EnableDecompression	Bu HttpWebClientProtocoliçin açmanın etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
PreAuthenticate	Ön kimlik doğrulamasının etkinleştirilip etkinleştirilmediğini alır veya ayarlar. (Devralındığı yer: WebClientProtocol)
Proxy	Bir güvenlik duvarı aracılığıyla XML Web hizmeti isteği oluşturmak için ara sunucu bilgilerini alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)
RequestEncoding	Encoding XML Web hizmetine istemci isteğinde bulunmak için kullanılır. (Devralındığı yer: WebClientProtocol)
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
Timeout	XML Web hizmeti istemcisinin zaman uyumlu bir XML Web hizmeti isteğinin yanıtlanmasını beklediği süreyi gösterir (milisaniye cinsinden). (Devralındığı yer: WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	İstemci, XML Web hizmetini barındıran Web sunucusuna bağlanmak için NTLM kimlik doğrulamasını kullandığında bağlantı paylaşımının etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)
Url	İstemcinin istediği XML Web hizmetinin temel URL'sini alır veya ayarlar. (Devralındığı yer: WebClientProtocol)
UseDefaultCredentials	Özelliğin özelliğinin değerine ayarlanıp ayarlanmayacağını Credentials belirten bir değer DefaultCredentials alır veya ayarlar. (Devralındığı yer: WebClientProtocol)
UserAgent	Her istekle birlikte gönderilen kullanıcı aracısı üst bilgisinin değerini alır veya ayarlar. (Devralındığı yer: HttpWebClientProtocol)

Yöntemler

Abort()	XML Web hizmeti yöntemine yönelik isteği iptal eder. (Devralındığı yer: WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	XML Web hizmeti yönteminin zaman uyumsuz çağrısını başlatır.
CancelAsync(Object)	Çağrı zaten tamamlanmadığı sürece XML Web hizmeti yöntemine yönelik zaman uyumsuz çağrıyı iptal eder. (Devralındığı yer: HttpWebClientProtocol)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
EndInvoke(IAsyncResult)	HTTP kullanarak XML Web hizmeti yönteminin zaman uyumsuz çağrısını tamamlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Kullanımdan kalktı. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetWebRequest(Uri)	Belirtilen URI için bir WebRequest oluşturur. (Devralındığı yer: HttpWebClientProtocol)
GetWebResponse(WebRequest)	Xml Web hizmeti yöntemine zaman uyumlu istekten bir yanıt döndürür. (Devralındığı yer: HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Xml Web hizmeti yöntemine zaman uyumsuz istekten bir yanıt döndürür. (Devralındığı yer: HttpWebClientProtocol)
InitializeLifetimeService()	Kullanımdan kalktı. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Invoke(String, String, Object[])	HTTP kullanarak bir XML Web hizmeti yöntemini çağırır.
InvokeAsync(String, String, Object[], SendOrPostCallback)	Belirtilen yöntemi zaman uyumsuz olarak çağırır.
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	İlişkili bir durumu korurken belirtilen yöntemi zaman uyumsuz olarak çağırır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)

İş Parçacığı Güvenliği

Bu güvenli iş parçacığı türüdür.

Ayrıca bkz.

• SoapHttpClientProtocol