HttpSimpleClientProtocol Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
-
HttpSimpleClientProtocol
- 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.