Aracılığıyla paylaş

SoapDocumentServiceAttribute Sınıf

Tanım

Ad Alanı:
System.Web.Services.Protocols
Bütünleştirilmiş Kod:
System.Web.Services.dll

İsteğe bağlı SoapDocumentServiceAttribute bir XML Web hizmetine uygulanması, XML Web hizmeti içindeki XML Web hizmeti yöntemlerine gönderilen ve XML'den gönderilen SOAP isteklerinin ve yanıtlarının varsayılan biçimini ayarlar.

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
Devralma
Object
Attribute
SoapDocumentServiceAttribute
Öznitelikler
AttributeUsageAttribute

Örnekler

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

Açıklamalar

, SoapDocumentServiceAttribute XML Web hizmeti içindeki XML Web hizmeti yöntemleri için varsayılan biçimlendirme stillerini ayarlamanıza olanak tanır. Tek bir XML Web hizmeti yönteminin bu varsayılanları değiştirmesi gerekiyorsa, bu XML Web hizmeti yöntemine bir SoapDocumentMethodAttribute uygulayın.

Web Hizmetleri Açıklama Dili (WSDL), bir IŞLEMI çağırdığı XML Web hizmeti yönteminin SOAP isteğinde veya SOAP yanıtında nasıl biçimlendirilebileceğine ilişkin iki stil tanımlar: RPC ve Document. Tek tek ileti bölümlerinin ve ParameterStyle özellikleri tarafından Use tam olarak nasıl belirlendiği. Use özelliği, parametrelerin biçimlendirilip Literalbiçimlendirilmeyeceğini Encoded belirler. , ParameterStyle parametrelerin öğesinin altındaki tek bir ileti parçası içinde kapsüllenip kapsülleneceğini veya her parametrenin Body tek bir ileti bölümü olup olmadığını belirler.

Varsayılan yöntem düzeyi biçimlendirmesini olarak ayarlamak için RPC, XML Web hizmetini uygulayan sınıfa bir SoapRpcServiceAttribute uygulayın.

Diğer ayrıntılar için bkz. SOAP İleti Biçimlendirmesini Özelleştirme.

Bu öznitelik, XML Web hizmeti uygulayan bir sınıfa uygulanabilir.

Oluşturucular

Name Description
SoapDocumentServiceAttribute()

Sınıfın SoapDocumentServiceAttribute yeni bir örneğini başlatır ve tüm özellikleri varsayılan değerlerine ayarlar.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Parametre biçimlendirmesini ayarlayan ve soap iletilerinde öğesinin SoapDocumentServiceAttribute altındaki tek bir XML öğesi içinde parametrelerin kapsüllenip kapsüllenmeyeceğini ayarlayan sınıfın Body yeni bir örneğini başlatır.
SoapDocumentServiceAttribute(SoapBindingUse)

Parametre biçimlendirmesini ayarlayarak sınıfın SoapDocumentServiceAttribute yeni bir örneğini başlatır.

Özellikler

Name Description
ParameterStyle

XML Web hizmetinin XML Web hizmeti yöntemleri için SOAP iletisinin XML bölümündeki öğesinden sonra <Body> parametrelerin tek bir öğe içinde kapsüllenip kapsülleneceğini denetleyebilen varsayılan ayarı alır veya ayarlar.
RoutingStyle

SOAP iletilerinin XML Web hizmetine nasıl yönlendirileceğini alır veya ayarlar.
TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)
Use

XML Web hizmeti için varsayılan parametre biçimlendirmesini alır veya ayarlar.

Yöntemler

Name Description
Equals(Object)

Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.

(Devralındığı yer: Attribute)
GetHashCode()

Bu örneğin karma kodunu döndürür.

(Devralındığı yer: Attribute)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
IsDefaultAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir.

(Devralındığı yer: Attribute)
Match(Object)

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.

(Devralındığı yer: Attribute)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

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

Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1).

(Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bir nesne tarafından kullanıma sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır

Ayrıca bkz.