SoapDocumentServiceAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

public ref class SoapDocumentServiceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type SoapDocumentServiceAttribute = class
    inherit Attribute

Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute

Ereditarietà: Object

Attribute
SoapDocumentServiceAttribute

Attributi: AttributeUsageAttribute

Esempio

<%@ 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

Commenti

Consente SoapDocumentServiceAttribute di impostare gli stili di formattazione predefiniti per i metodi di servizio Web XML all'interno di un servizio Web XML. Se un singolo metodo di servizio Web XML deve modificare queste impostazioni predefinite, applicare un SoapDocumentMethodAttribute oggetto al metodo del servizio Web XML.

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 in una risposta SOAP: RPC e Document. Esattamente come le singole parti del messaggio sono determinate dalle Use proprietà e ParameterStyle . La Use proprietà determina se i parametri sono formattati Encoded o Literal. Determina ParameterStyle se i parametri sono incapsulati all'interno di una singola parte del messaggio sotto l'elemento Body o se ogni parametro è una singola parte del messaggio.

Per impostare la formattazione a livello di metodo predefinita su RPC, applicare un SoapRpcServiceAttribute a alla classe che implementa il servizio Web XML.

Per altre informazioni, vedere Personalizzazione della formattazione dei messaggi SOAP.

Questo attributo può essere applicato a una classe che implementa un servizio Web XML.

Costruttori

SoapDocumentServiceAttribute()	Inizializza una nuova istanza della classe SoapDocumentServiceAttribute impostando tutte le proprietà sui relativi valori predefiniti.
SoapDocumentServiceAttribute(SoapBindingUse)	Inizializza una nuova istanza della classe SoapDocumentServiceAttribute impostando la formattazione dei parametri.
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.

Proprietà

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.
RoutingStyle	Ottiene o imposta la modalità di reindirizzamento dei messaggi SOAP al servizio Web XML.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
Use	Ottiene o imposta la formattazione dei parametri predefinita per un servizio Web XML.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da 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. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a

Condividi tramite