Condividi tramite

SoapDocumentServiceAttribute Classe

Definizione

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

L'applicazione del SoapDocumentServiceAttribute facoltativo a un servizio Web XML imposta il formato predefinito delle richieste SOAP e delle risposte inviate da e verso 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

SoapDocumentServiceAttribute Consente di impostare gli stili di formattazione predefiniti per i metodi del 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 a tale metodo di 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. ParameterStyle Determina se i parametri vengono incapsulati all'interno di una singola parte del messaggio sotto l'elemento o se ogni parametro è una singola parte del Body messaggio.

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

Per altri dettagli, vedere Personalizzazione della formattazione dei messaggi SOAP.

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

Costruttori

Nome Descrizione
SoapDocumentServiceAttribute()

Inizializza una nuova istanza della SoapDocumentServiceAttribute classe impostando tutte le proprietà sui valori predefiniti.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Inizializza una nuova istanza della SoapDocumentServiceAttribute classe che imposta la formattazione dei parametri e imposta se i parametri vengono incapsulati all'interno di un singolo elemento XML, sotto l'elemento Body , nei messaggi SOAP.
SoapDocumentServiceAttribute(SoapBindingUse)

Inizializza una nuova istanza della SoapDocumentServiceAttribute classe impostando la formattazione dei parametri.

Proprietà

Nome Descrizione
ParameterStyle

Ottiene o imposta l'impostazione predefinita che controlla se i parametri vengono incapsulati all'interno di un singolo elemento che segue l'elemento <Body> nella parte XML di un messaggio SOAP per i metodi del servizio Web XML.
RoutingStyle

Ottiene o imposta il modo in cui i messaggi SOAP vengono indirizzati al servizio Web XML.
TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)
Use

Ottiene o imposta la formattazione predefinita dei parametri per un servizio Web XML.

Metodi

Nome Descrizione
Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per questa istanza.

(Ereditato da Attribute)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

Quando sottoposto a 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 è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
_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 per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per 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 alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a

Vedi anche