Jo Shields a575963da9 Imported Upstream version 3.6.0
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
2014-08-13 10:39:27 +01:00

326 lines
18 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Type Name="XmlFormatExtensionAttribute" FullName="System.Web.Services.Configuration.XmlFormatExtensionAttribute">
<TypeSignature Language="C#" Maintainer="auto" Value="public sealed class XmlFormatExtensionAttribute : Attribute" />
<AssemblyInfo>
<AssemblyName>System.Web.Services</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A service description format extension extends how a service description is generated for an XML Web service created using ASP.NET. Specifically, a service description format extension adds XML elements to the service description. This is useful when a SOAP extension is built to run on both the client and server side of an XML Web service, as information about SOAP extensions is not placed in the service description. If you want to add information about the SOAP extension to the service description, a client can interpret that it must run the specific SOAP extension. An example of a SOAP extension that must run on both the client and server is an encryption SOAP extension. If an encryption SOAP extension runs only on the server and it encrypts return values before sending them back to the client, the client must have the SOAP extension running to decrypt the SOAP message. Otherwise, the client cannot process the return value.</para>
<para>Use the following steps to build a service description format extension: </para>
<list type="ordered">
<item>
<para>Build a class that derives from <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" />.</para>
</item>
<item>
<para>Apply a <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> to the class and specify the extension points at which the service description format extension should run.</para>
</item>
<item>
<para>Optionally, apply a <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionPointAttribute" /> to the class and specify a member within the class that acts as a new extension point.</para>
</item>
<item>
<para>Optionally, apply a <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionPrefixAttribute" /> to the class and specify the XML namespace prefix to be associated with XML elements generated by the service description format extension.</para>
</item>
<item>
<para>Configure the service description format extension to run within the serviceDescriptionFormatExtensionTypes section of the configuration file.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that a service description format extension runs at one or more extension points. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute (string elementName, string ns, Type extensionPoint1);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="extensionPoint1" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class that specifies the XML element and namespace to add when running at the specified extension point.</para>
</summary>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element added to the service description by the service description format extension.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The XML namespace for the XML element added to the service description by the service description format extension.</param>
<param name="extensionPoint1">
<attribution license="cc4" from="Microsoft" modified="false" />The extension point at which to run the service description format extension.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute (string elementName, string ns, Type[] extensionPoints);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="extensionPoints" Type="System.Type[]" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class that specifies the XML element and namespace to add when running at the specified extension points.</para>
</summary>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element added to the service description by the service description format extension. </param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The XML namespace for the XML element added to the service description by the service description format extension. </param>
<param name="extensionPoints">
<attribution license="cc4" from="Microsoft" modified="false" />An array of extension points at which to run the service description format extension. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute (string elementName, string ns, Type extensionPoint1, Type extensionPoint2);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="extensionPoint1" Type="System.Type" />
<Parameter Name="extensionPoint2" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class that specifies the XML element and namespace to add when running at the specified extension points.</para>
</summary>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element added to the service description by the service description format extension.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The XML namespace for the XML element added to the service description by the service description format extension.</param>
<param name="extensionPoint1">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint2">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute (string elementName, string ns, Type extensionPoint1, Type extensionPoint2, Type extensionPoint3);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="extensionPoint1" Type="System.Type" />
<Parameter Name="extensionPoint2" Type="System.Type" />
<Parameter Name="extensionPoint3" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class that specifies the XML element and namespace to add when running at the specified extension points.</para>
</summary>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element added to the service description by the service description format extension.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The XML namespace for the XML element added to the service description by the service description format extension.</param>
<param name="extensionPoint1">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint2">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint3">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public XmlFormatExtensionAttribute (string elementName, string ns, Type extensionPoint1, Type extensionPoint2, Type extensionPoint3, Type extensionPoint4);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="extensionPoint1" Type="System.Type" />
<Parameter Name="extensionPoint2" Type="System.Type" />
<Parameter Name="extensionPoint3" Type="System.Type" />
<Parameter Name="extensionPoint4" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Configuration.XmlFormatExtensionAttribute" /> class that specifies the XML element and namespace to add when running at the specified extension points.</para>
</summary>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element added to the service description by the service description format extension.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The XML namespace for the XML element added to the service description by the service description format extension.</param>
<param name="extensionPoint1">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint2">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint3">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension.</param>
<param name="extensionPoint4">
<attribution license="cc4" from="Microsoft" modified="false" />An extension point at which to run the service description format extension. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ElementName">
<MemberSignature Language="C#" Value="public string ElementName { set; get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the XML element added to the service description by the service description format extension.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ExtensionPoints">
<MemberSignature Language="C#" Value="public Type[] ExtensionPoints { set; get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Type[]</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'Type []'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The list of available types with which a service description format extension can run include those built into ASP.NET and any custom types configured on the Web server. The types built into ASP.NET that can run with a service description format extension are in the following list: </para>
<list type="bullet">
<item>
<para>
<see cref="T:System.Web.Services.Description.Binding" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.OperationBinding" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.FaultBinding" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.InputBinding" />
</para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.OutputBinding" />
</para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.Operation" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.Types" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.Port" /> </para>
</item>
<item>
<para>
<see cref="T:System.Web.Services.Description.ServiceDescription" />
</para>
</item>
</list>
<para>These classes all refer to sections, within a service description, that are generated by ASP.NET.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The stages at which the service description format extension is to run.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Namespace">
<MemberSignature Language="C#" Value="public string Namespace { set; get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the XML namespace for the XML element added to the service description by the service description format extension.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>