SoapDocumentServiceAttribute Class

Definition

L'applicazione dell'oggetto SoapDocumentServiceAttribute facoltativo a un servizio Web XML consente di impostare il formato predefinito di richieste e risposte SOAP inviate da e per i metodi del servizio Web XML all'interno del servizio Web XML.Applying the optional SoapDocumentServiceAttribute to an XML Web service sets the default format of SOAP requests and responses sent to and from XML Web service methods within the XML Web service.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public sealed class SoapDocumentServiceAttribute : Attribute
type SoapDocumentServiceAttribute = class
    inherit Attribute
Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute
Inheritance
SoapDocumentServiceAttribute
Attributes

Examples

<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }
    }
<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             RoutingStyle := SoapServiceRoutingStyle.SoapAction)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
    
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class

Remarks

SoapDocumentServiceAttribute Consente di impostare gli stili di formattazione predefiniti per i metodi del servizio Web XML all'interno di un servizio Web XML.The SoapDocumentServiceAttribute allows you to set the default formatting styles for XML Web service methods within an XML Web service. Se un singolo metodo di servizio Web XML deve modificare queste impostazioni predefinite, applicare SoapDocumentMethodAttribute un oggetto al metodo del servizio Web XML.If an individual XML Web service method must change these defaults, apply a SoapDocumentMethodAttribute to that XML Web service method.

Web Services Description Language (WSDL) definisce due stili per il modo in cui un metodo di servizio Web XML, che chiama un'operazione, può essere formattato in una richiesta SOAP o RPC in Documentuna risposta SOAP: e.Web Services Description Language (WSDL) defines two styles for how an XML Web service method, which it calls an operation, can be formatted in a SOAP request or a SOAP response: RPC and Document. Indica esattamente come le singole parti del messaggio sono determinate Use dalle ParameterStyle proprietà e.Exactly how the individual message parts is determined by the Use and ParameterStyle properties. La Use proprietà determina se i parametri sono Encoded formattati o Literal.The Use property determines whether parameters are formatted Encoded or Literal. Determina se i parametri vengono incapsulati all'interno di una singola parte del Body messaggio sotto l'elemento o se ogni parametro è una parte del singolo messaggio. ParameterStyleThe ParameterStyle determines whether the parameters are encapsulated within a single message part beneath the Body element, or whether each parameter is an individual message part.

Per impostare la formattazione predefinita a livello di RPCmetodo su, SoapRpcServiceAttribute applicare un alla classe che implementa il servizio Web XML.To set the default method level formatting to RPC, apply a SoapRpcServiceAttribute to the class implementing the XML Web service.

Per ulteriori informazioni, vedere personalizzazione della formattazione dei messaggi SOAP.For more details, see Customizing SOAP Message Formatting.

Questo attributo può essere applicato a una classe che implementa un servizio Web XML.This attribute can be applied to a class implementing an XML Web service.

Constructors

SoapDocumentServiceAttribute()

Inizializza una nuova istanza della classe SoapDocumentServiceAttribute impostando tutte le proprietà sui relativi valori predefiniti.Initializes a new instance of the SoapDocumentServiceAttribute class setting all properties to their default values.

SoapDocumentServiceAttribute(SoapBindingUse)

Inizializza una nuova istanza della classe SoapDocumentServiceAttribute impostando la formattazione dei parametri.Initializes a new instance of the SoapDocumentServiceAttribute class setting the parameter formatting.

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Inizializza una nuova istanza della classe SoapDocumentServiceAttribute che consente di impostare la formattazione dei parametri e di stabilire se i parametri vengono incapsulati all'interno di un singolo elemento XML, sotto l'elemento Body, nei messaggi SOAP.Initializes a new instance of the SoapDocumentServiceAttribute class that sets the parameter formatting and sets whether parameters are encapsulated within a single XML element, under the Body element, in SOAP messages.

Properties

ParameterStyle

Ottiene o imposta l'impostazione predefinita che consente di stabilire se i parametri vengono incapsulati all'interno di un singolo elemento che segue l'elemento <Body> nella porzione XML di un messaggio SOAP per i metodi del servizio Web XML del servizio Web XML.Gets or sets the default setting that controls whether parameters are encapsulated within a single element following the <Body> element in the XML portion of a SOAP message for XML Web service methods of the XML Web service.

RoutingStyle

Ottiene o imposta la modalità di reindirizzamento dei messaggi SOAP al servizio Web XML.Gets or sets how SOAP messages are routed to the XML Web service.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
Use

Ottiene o imposta la formattazione dei parametri predefinita per un servizio Web XML.Gets or sets the default parameter formatting for an XML Web service.

Methods

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode()

Restituisce il codice hash relativo a questa istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also