SoapDocumentServiceAttribute Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Services.Protocols

Bütünleştirilmiş Kod:: System.Web.Services.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İsteğe bağlı SoapDocumentServiceAttribute öğesinin bir XML Web hizmetine uygulanması, XML Web hizmeti içindeki XML Web hizmeti yöntemlerine gönderilen ve bu yöntemden 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 bir 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 biçimlendirilmeyeceğini Encoded belirler.Literal , ParameterStyle parametrelerin öğesinin altındaki tek bir ileti parçası içinde kapsüllenip kapsüllenmeyeceğ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

SoapDocumentServiceAttribute()	Sınıfın SoapDocumentServiceAttribute yeni bir örneğini başlatır ve tüm özellikleri varsayılan değerlerine ayarlar.
SoapDocumentServiceAttribute(SoapBindingUse)	Parametre biçimlendirmesini ayarlayarak sınıfın SoapDocumentServiceAttribute yeni bir örneğini başlatır.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)	Parametre biçimlendirmesini ayarlayan ve soap iletilerinde öğesinin SoapDocumentServiceAttribute altındaki tek bir XML öğesinde parametrelerin kapsüllenip kapsüllenmeyeceğini ayarlayan sınıfın `Body` yeni bir örneğini başlatır.

Özellikler

ParameterStyle	XML Web hizmetinin XML Web hizmeti yöntemleri için SOAP iletisinin XML bölümündeki öğeden sonra `<Body>` parametrelerin tek bir öğe içinde kapsüllenip kapsüllenmeyeceğini denetleen 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

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini 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ı belirten bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

_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 sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Şunlara uygulanır