HttpSimpleClientProtocol Klass

Definition

Representerar basklassen för kommunikation med en XML-webbtjänst med hjälp av enkla HTTP-GET- och HTTP-POST protokollbindningar.

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
Arv
Härledda
Attribut

Exempel

Följande kodexempel är en proxyklass som genereras av Wsdl.exe för Math XML-webbtjänsten nedan. Proxyklassen härleds från HttpGetClientProtocol, som härleds från den abstrakta HttpSimpleClientProtocol klassen.

#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

Följande kodexempel är Math XML-webbtjänsten, från vilken den föregående proxyklassen skapades.

#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

Kommentarer

Den här klassen anger det mesta av implementeringen för kommunikation med en XML-webbtjänst via HTTP med kodare för att koda parametrarna och returnera värden i vanliga MIME-format. Dessa kodare härleds från MimeFormatter klassen. Som standard är en proxyklass som härleds från HttpSimpleClientProtocol kodningsparametrar med hjälp av MIME-typen application/x-www-form-urlencoded och svaret i oformaterad XML. Anpassade mime-formatters kan anges med hjälp av HttpMethodAttribute attributet, men det finns inget stöd för att integrera detta i en tjänstbeskrivning och proxygenerering.

Notes to Inheritors: När du åsidosätter den här klassen kan du introducera metoder i den härledda klassen som är specifika för en viss typ av en XML-webbtjänst. Metoderna samlar helt enkelt in parametrarna och anropar basklassen för att utföra arbetet med att kommunicera med webbplatsen. Om de introducerade metoderna är asynkrona anropar du BeginInvoke metoderna och EndInvoke . Om de introducerade metoderna är synkrona anropar du Invoke metoden. Den åsidosatta konstruktorn anger Url vanligtvis egenskapen till URI:n för XML-webbtjänstmetoden.

Verktyget Web Services Description Language (Wsdl.exe) genererar härledda klasser av HttpSimpleClientProtocol för en viss tjänstbeskrivning.

Konstruktorer

Name Description
HttpSimpleClientProtocol()

Initierar en ny instans av HttpSimpleClientProtocol klassen.

Egenskaper

Name Description
AllowAutoRedirect

Hämtar eller anger om klienten automatiskt följer serveromdirigeringar.

(Ärvd från HttpWebClientProtocol)
CanRaiseEvents

Hämtar ett värde som anger om komponenten kan generera en händelse.

(Ärvd från Component)
ClientCertificates

Hämtar samlingen med klientcertifikat.

(Ärvd från HttpWebClientProtocol)
ConnectionGroupName

Hämtar eller anger namnet på anslutningsgruppen för begäran.

(Ärvd från WebClientProtocol)
Container

Hämtar som IContainer innehåller Component.

(Ärvd från Component)
CookieContainer

Hämtar eller anger insamling av cookies.

(Ärvd från HttpWebClientProtocol)
Credentials

Hämtar eller anger säkerhetsautentiseringsuppgifter för XML-webbtjänstklientautentisering.

(Ärvd från WebClientProtocol)
DesignMode

Hämtar ett värde som anger om det Component för närvarande är i designläge.

(Ärvd från Component)
EnableDecompression

Hämtar eller anger ett värde som anger om dekomprimering är aktiverat för detta HttpWebClientProtocol.

(Ärvd från HttpWebClientProtocol)
Events

Hämtar listan över händelsehanterare som är kopplade till den här Component.

(Ärvd från Component)
PreAuthenticate

Hämtar eller anger om förautentisering är aktiverat.

(Ärvd från WebClientProtocol)
Proxy

Hämtar eller anger proxyinformation för att göra en XML-webbtjänstbegäran via en brandvägg.

(Ärvd från HttpWebClientProtocol)
RequestEncoding

Används Encoding för att göra klientbegäran till XML-webbtjänsten.

(Ärvd från WebClientProtocol)
Site

Hämtar eller ställer in ISite i Component.

(Ärvd från Component)
Timeout

Anger den tid då en XML-webbtjänstklient väntar på att svaret på en synkron XML-webbtjänstbegäran ska tas emot (i millisekunder).

(Ärvd från WebClientProtocol)
UnsafeAuthenticatedConnectionSharing

Hämtar eller anger ett värde som anger om anslutningsdelning är aktiverat när klienten använder NTLM-autentisering för att ansluta till den webbserver som är värd för XML-webbtjänsten.

(Ärvd från HttpWebClientProtocol)
Url

Hämtar eller anger bas-URL:en för DEN XML-webbtjänst som klienten begär.

(Ärvd från WebClientProtocol)
UseDefaultCredentials

Hämtar eller anger ett värde som anger om egenskapen ska anges Credentials till egenskapens DefaultCredentials värde.

(Ärvd från WebClientProtocol)
UserAgent

Hämtar eller anger värdet för användaragenthuvudet som skickas med varje begäran.

(Ärvd från HttpWebClientProtocol)

Metoder

Name Description
Abort()

Avbryter en begäran till en XML-webbtjänstmetod.

(Ärvd från WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)

Startar en asynkron anrop av en metod för en XML-webbtjänst.

CancelAsync(Object)

Avbryter ett asynkront anrop till en XML-webbtjänstmetod, såvida inte anropet redan har slutförts.

(Ärvd från HttpWebClientProtocol)
CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
Dispose()

Släpper alla resurser som används av Component.

(Ärvd från Component)
Dispose(Boolean)

Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna.

(Ärvd från Component)
EndInvoke(IAsyncResult)

Slutför asynkron anrop av en XML-webbtjänstmetod med hjälp av HTTP.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLifetimeService()
Föråldrad.

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetService(Type)

Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container.

(Ärvd från Component)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetWebRequest(Uri)

Skapar en WebRequest för den angivna URI:n.

(Ärvd från HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)

Returnerar ett svar från en asynkron begäran till en XML-webbtjänstmetod.

(Ärvd från HttpWebClientProtocol)
GetWebResponse(WebRequest)

Returnerar ett svar från en synkron begäran till en XML-webbtjänstmetod.

(Ärvd från HttpWebClientProtocol)
InitializeLifetimeService()
Föråldrad.

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
Invoke(String, String, Object[])

Anropar en XML-webbtjänstmetod med HTTP.

InvokeAsync(String, String, Object[], SendOrPostCallback, Object)

Anropar den angivna metoden asynkront samtidigt som ett associerat tillstånd upprätthålls.

InvokeAsync(String, String, Object[], SendOrPostCallback)

Anropar den angivna metoden asynkront.

MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
ToString()

Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas.

(Ärvd från Component)

Händelser

Name Description
Disposed

Inträffar när komponenten tas bort av ett anrop till Dispose() metoden.

(Ärvd från Component)

Gäller för

Trådsäkerhet

Den här typen är trådsäker.

Se även