SoapExtensionAttribute 类

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

当在派生类中重写时，指定 SOAP 扩展应该与 XML Web services 方法一起运行。

public ref class SoapExtensionAttribute abstract : Attribute

public abstract class SoapExtensionAttribute : Attribute

type SoapExtensionAttribute = class
    inherit Attribute

Public MustInherit Class SoapExtensionAttribute
Inherits Attribute

继承

Object

Attribute

SoapExtensionAttribute

示例

以下 TraceExtensionAttribute 类派生自 SoapExtensionAttribute 支持将属性应用于 XML Web 服务方法或 XML Web 服务客户端代理类中的方法。 应用于任一方法时， TraceExtension SOAP 扩展将运行。

// Create a SoapExtensionAttribute for a SOAP extension that can be
// applied to an XML Web service method.

[AttributeUsage(AttributeTargets::Method)]
public ref class TraceExtensionAttribute: public SoapExtensionAttribute
{
private:
   String^ myFilename;
   int myPriority;

public:

   // Set the name of the log file were SOAP messages will be stored.
   TraceExtensionAttribute()
      : SoapExtensionAttribute()
   {
      myFilename = "C:\\logClient.txt";
   }

   property Type^ ExtensionType 
   {
      // Return the type of 'TraceExtension' class.
      virtual Type^ get() override
      {
         return TraceExtension::typeid;
      }
   }

   property int Priority 
   {
      // User can set priority of the 'SoapExtension'.
      virtual int get() override
      {
         return myPriority;
      }

      virtual void set( int value ) override
      {
         myPriority = value;
      }
   }

   property String^ Filename 
   {
      String^ get()
      {
         return myFilename;
      }

      void set( String^ value )
      {
         myFilename = value;
      }
   }
};

// Create a SoapExtensionAttribute for a SOAP extension that can be
// applied to an XML Web service method.
[AttributeUsage(AttributeTargets.Method)]
public class TraceExtensionAttribute : SoapExtensionAttribute {

    private string myFilename;
    private int myPriority;

    // Set the name of the log file were SOAP messages will be stored.
    public TraceExtensionAttribute() : base()
    {
        myFilename = "C:\\logClient.txt";
    }

    // Return the type of 'TraceExtension' class.
    public override Type ExtensionType
    {
        get
        {
            return typeof(TraceExtension);
        }
    }

    // User can set priority of the 'SoapExtension'.
    public override int Priority
    {
        get
        {
            return myPriority;
        }
        set
        {
            myPriority = value;
        }
    }

    public string Filename
    {
        get
        {
            return myFilename;
        }
        set
        {
            myFilename = value;
        }
    }
}

' Create a SoapExtensionAttribute for a SOAP extension that can be
' applied to an XML Web service method.
<AttributeUsage(AttributeTargets.Method)> _
Public Class TraceExtensionAttribute
    Inherits SoapExtensionAttribute
    
    Private m_filename As String = "c:\log.txt"
    Private m_priority As Integer

   ' Return the type of 'TraceExtension' class.
    Public Overrides ReadOnly Property ExtensionType() As Type
        Get
            Return GetType(TraceExtension)
        End Get
    End Property

   ' User can set priority of the 'TraceExtension'.
    Public Overrides Property Priority() As Integer
        Get
            Return m_priority
        End Get
        Set(ByVal Value As Integer)
            m_priority = value
        End Set
    End Property

    Public Property Filename() As String
        Get
            Return m_filename
        End Get
        Set(ByVal Value As String)
            m_filename = value
        End Set
    End Property
End Class

注解

可以使用 ASP.NET 创建的 XML Web 服务方法配置为使用 SOAP 扩展运行，方法是将属性应用于 XML Web 服务方法。 将自定义扩展属性添加到客户端代理类上的 XML Web 服务方法或方法时，ASP.NET 适当时调用关联的扩展。 扩展属性是派生自 SoapExtensionAttribute的自定义属性类。 派生属性必须重写 ExtensionType 该属性才能返回与该属性关联的扩展类型。

构造函数

SoapExtensionAttribute()

初始化 SoapExtensionAttribute 类的新实例。

属性

ExtensionType	当在派生类中被重写时，获取 SOAP 扩展的 Type。
Priority	当在派生类中被重写时，获取或设置 SOAP 扩展的优先级。
TypeId	在派生类中实现时，获取此 Attribute 的唯一标识符。 (继承自 Attribute)

方法

Equals(Object)	返回一个值，该值指示此实例是否与指定的对象相等。 (继承自 Attribute)
GetHashCode()	返回此实例的哈希代码。 (继承自 Attribute)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsDefaultAttribute()	在派生类中重写时，指示此实例的值是否是派生类的默认值。 (继承自 Attribute)
Match(Object)	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	将一组名称映射为对应的一组调度标识符。 (继承自 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	检索对象的类型信息，然后可以使用该信息获取接口的类型信息。 (继承自 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	检索对象提供的类型信息接口的数量（0 或 1）。 (继承自 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供对某一对象公开的属性和方法的访问。 (继承自 Attribute)

另请参阅

• SoapExtension
• SoapMessage