SoapMethodAttribute Klas

Definitie

Naamruimte:

System.Runtime.Remoting.Metadata

Assembly:

mscorlib.dll

Het genereren en verwerken van SOAP wordt aangepast voor een methode. Deze klasse kan niet worden overgenomen.

public ref class SoapMethodAttribute sealed : System::Runtime::Remoting::Metadata::SoapAttribute

[System.AttributeUsage(System.AttributeTargets.Method)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapMethodAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapMethodAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapMethodAttribute
Inherits SoapAttribute

Overname

Object

Attribute

SoapAttribute

SoapMethodAttribute

Kenmerken

AttributeUsageAttribute ComVisibleAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de leden in de SoapMethodAttribute klasse kunt gebruiken om soap-generatie en -verwerking voor een methode aan te passen.

#using <System.dll>
#using <System.Runtime.Remoting.dll>
using namespace System;
using namespace System::Runtime::Remoting::Metadata;

namespace ExampleNamespace
{
   public ref class ExampleClass
   {
   public:
      [SoapMethod(
         ResponseXmlElementName="ExampleResponseElement",
         ResponseXmlNamespace=
         "http://example.org/MethodResponseXmlNamespace",
         ReturnXmlElementName="HelloMessage",
         SoapAction="http://example.org/ExampleSoapAction#GetHello",
         XmlNamespace="http://example.org/MethodCallXmlNamespace")]
      String^ GetHello( String^ name )
      {
         return String::Format( L"Hello, {0}", name );
      }
   };

}

int main()
{
   
   // Get the method info object for the GetHello method.
   System::Reflection::MethodBase^ getHelloMethod = 
      ExampleNamespace::ExampleClass::typeid->GetMethod( L"GetHello" );
   
   // Print the XML namespace for the invocation of this method.
   String^ methodCallXmlNamespace =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The XML namespace for the response of the method "
         L"GetHello in ExampleClass is {0}.", methodCallXmlNamespace );
   
   // Print the XML namespace for the response of this method.
   String^ methodResponseXmlNamespace =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The XML namespace for the invocation of the method "
         L"GetHello in ExampleClass is {0}.", methodResponseXmlNamespace );
   
   // Print the SOAP action for this method.
   String^ getHelloSoapAction =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The SOAP action for the method "
         L"GetHello in ExampleClass is {0}.", getHelloSoapAction );
}

using System;
using System.Runtime.Remoting.Metadata;

namespace ExampleNamespace
{
    public class ExampleClass
    {
        [SoapMethod(
             ResponseXmlElementName="ExampleResponseElement",
             ResponseXmlNamespace=
                "http://example.org/MethodResponseXmlNamespace",
             ReturnXmlElementName="HelloMessage",
             SoapAction="http://example.org/ExampleSoapAction#GetHello",
             XmlNamespace="http://example.org/MethodCallXmlNamespace")]
        public string GetHello(string name)
        {
            return "Hello, " + name;
        }
    }
}

public class Demo
{
    public static void Main(string[] args)
    {
        // Get the method info object for the GetHello method.
        System.Reflection.MethodBase getHelloMethod =
            typeof(ExampleNamespace.ExampleClass).GetMethod("GetHello");

        // Print the XML namespace for the invocation of this method.
        string methodCallXmlNamespace =
            System.Runtime.Remoting.SoapServices.
                GetXmlNamespaceForMethodCall(getHelloMethod);
        Console.WriteLine(
            "The XML namespace for the response of the method " +
            "GetHello in ExampleClass is {0}.",
            methodCallXmlNamespace);

        // Print the XML namespace for the response of this method.
        string methodResponseXmlNamespace =
            System.Runtime.Remoting.SoapServices.
                GetXmlNamespaceForMethodResponse(getHelloMethod);
        Console.WriteLine(
            "The XML namespace for the invocation of the method " +
            "GetHello in ExampleClass is {0}.",
            methodResponseXmlNamespace);

        // Print the SOAP action for this method.
        string getHelloSoapAction =
            System.Runtime.Remoting.SoapServices.
                GetSoapActionFromMethodBase(getHelloMethod);
        Console.WriteLine(
            "The SOAP action for the method " +
            "GetHello in ExampleClass is {0}.",
            getHelloSoapAction);
    }
}

Opmerkingen

De doelobjecten voor het SoapMethodAttribute kenmerk zijn methoden die op afstand kunnen worden aangeroepen. Pas de SoapMethodAttribute toepassing toe om SOAP-generatie en -verwerking aan te passen. Met eigenschappen van dit kenmerk kan de programmeur het veld SOAPAction HTTP-header aanpassen om de intentie van de SOAP HTTP-aanvraag aan te geven.

Constructors

Name	Description
SoapMethodAttribute()	Hiermee maakt u een exemplaar van SoapMethodAttribute.

Velden

Name	Description
ProtXmlNamespace	De XML-naamruimte waarnaar het doel van het huidige SOAP-kenmerk wordt geserialiseerd. (Overgenomen van SoapAttribute)
ReflectInfo	Een weerspiegelingsobject dat wordt gebruikt door kenmerkklassen die zijn afgeleid van de SoapAttribute klasse om XML-serialisatiegegevens in te stellen. (Overgenomen van SoapAttribute)

Eigenschappen

Name	Description
Embedded	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het type moet worden genest tijdens soap-serialisatie. (Overgenomen van SoapAttribute)
ResponseXmlElementName	Hiermee haalt u de naam van het XML-element op of stelt u deze in voor het methodeantwoord op de doelmethode.
ResponseXmlNamespace	Hiermee wordt de XML-elementnaamruimte opgehaald of ingesteld die wordt gebruikt voor de methoderespons op de doelmethode.
ReturnXmlElementName	Hiermee haalt u de xml-elementnaam op die wordt gebruikt voor de retourwaarde van de doelmethode.
SoapAction	Hiermee haalt u het veld SOAPAction-header op dat wordt gebruikt met HTTP-aanvragen die met deze methode worden verzonden. Deze eigenschap is momenteel niet geïmplementeerd.
TypeId	Wanneer deze wordt geïmplementeerd in een afgeleide klasse, krijgt u Attributehiervoor een unieke id. (Overgenomen van Attribute)
UseAttribute	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het doel van het huidige kenmerk wordt geserialiseerd als een XML-kenmerk in plaats van een XML-veld.
XmlNamespace	Hiermee wordt de XML-naamruimte opgehaald of ingesteld die wordt gebruikt tijdens het serialiseren van externe methode-aanroepen van de doelmethode.

Methoden

Name	Description
Equals(Object)	Retourneert een waarde die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute)
GetHashCode()	Retourneert de hash-code voor dit exemplaar. (Overgenomen van Attribute)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IsDefaultAttribute()	Wanneer deze wordt overschreven in een afgeleide klasse, geeft u aan of de waarde van dit exemplaar de standaardwaarde is voor de afgeleide klasse. (Overgenomen van Attribute)
Match(Object)	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde geretourneerd die aangeeft of dit exemplaar gelijk is aan een opgegeven object. (Overgenomen van Attribute)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Expliciete interface-implementaties

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Hiermee wordt een set namen toegewezen aan een bijbehorende set verzend-id's. (Overgenomen van Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Hiermee haalt u de typegegevens voor een object op, die kan worden gebruikt om de typegegevens voor een interface op te halen. (Overgenomen van Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Hiermee wordt het aantal type-informatieinterfaces opgehaald dat een object biedt (0 of 1). (Overgenomen van Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Biedt toegang tot eigenschappen en methoden die door een object worden weergegeven. (Overgenomen van Attribute)