OperationContractGenerationContext 类

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.dll

传递给 GenerateOperation(OperationContractGenerationContext) 方法可以在生成代码之前修改操作协定及其上下文。

public ref class OperationContractGenerationContext

public class OperationContractGenerationContext

type OperationContractGenerationContext = class

Public Class OperationContractGenerationContext

继承

Object

OperationContractGenerationContext

示例

下面的示例演示了如何使用传递给 OperationContractGenerationContext 方法的 IOperationContractGenerationExtension.GenerateOperation 对象，来添加从自定义 WSDL 元素提取的代码注释。

public void GenerateOperation(OperationContractGenerationContext context)
{
  context.SyncMethod.Comments.AddRange(Formatter.FormatComments(commentText));
  Console.WriteLine("In generate operation.");
}

下面的代码示例给出了所生成的代码注释。

/// From WSDL Documentation:
///
/// <summary>This contract is a stateless contract that provides a mechanism for
/// computing the nth Fibonacci term.</summary>
///
[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(Namespace="http://microsoft.wcf.documentation", ConfigurationName="IFibonacci")]
public interface IFibonacci
{

    /// From WSDL Documentation:
    ///
    /// <summary>The Compute operation returns the nth Fibonacci number.  Because it
    /// uses dual recursion it's very inefficient and therefore useful to demonstrate
    /// caching.</summary><returns>The nth Fibonacci number.</returns><param
    /// name="num">The value to use when computing the Fibonacci number.</param>
    ///
    [System.ServiceModel.OperationContractAttribute(Action="http://microsoft.wcf.documentation/IFibonacci/Compute", ReplyAction="http://microsoft.wcf.documentation/IFibonacci/ComputeResponse")]
    int Compute(int num);

    /// From WSDL Documentation:
    ///
    /// <summary>The GetPerson operation tests custom WSDL documentation
    /// generation.</summary><returns>The Person object to be returned.</returns><param
    /// name="FirstParameter">The value for the first parameter.</param><param
    /// name="SecondParameter">The value for the second parameter.</param>
    ///
    [System.ServiceModel.OperationContractAttribute(Action="http://microsoft.wcf.documentation/IFibonacci/GetPerson", ReplyAction="http://microsoft.wcf.documentation/IFibonacci/GetPersonResponse")]
    Microsoft.WCF.Documentation.Person GetPerson(int FirstParameter, int SecondParameter);
}

'''From WSDL Documentation:
'''
'''<summary>This contract is a stateless contract that provides a mechanism for 
'''computing the nth Fibonacci term.</summary> 
'''
<System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0"),  _
 System.ServiceModel.ServiceContractAttribute([Namespace]:="http://microsoft.wcf.documentation", ConfigurationName:="IFibonacci")>  _
Public Interface IFibonacci
    
    '''From WSDL Documentation:
    '''
    '''<summary>The Compute operation returns the nth Fibonacci number.  Because it 
    '''uses dual recursion it's very inefficient and therefore useful to demonstrate 
    '''caching.</summary><returns>The nth Fibonacci number.</returns><param 
    '''name="num">The value to use when computing the Fibonacci number.</param> 
    '''
    <System.ServiceModel.OperationContractAttribute(Action:="http://microsoft.wcf.documentation/IFibonacci/Compute", ReplyAction:="http://microsoft.wcf.documentation/IFibonacci/ComputeResponse")>  _
    Function Compute(ByVal num As Integer) As Integer
    
    '''From WSDL Documentation:
    '''
    '''<summary>The GetPerson operation tests custom WSDL documentation 
    '''generation.</summary><returns>The Person object to be returned.</returns><param 
    '''name="FirstParameter">The value for the first parameter.</param><param 
    '''name="SecondParameter">The value for the second parameter.</param> 
    '''
    <System.ServiceModel.OperationContractAttribute(Action:="http://microsoft.wcf.documentation/IFibonacci/GetPerson", ReplyAction:="http://microsoft.wcf.documentation/IFibonacci/GetPersonResponse")>  _
    Function GetPerson(ByVal FirstParameter As Integer, ByVal SecondParameter As Integer) As Microsoft.WCF.Documentation.Person
End Interface

注解

使用传递给 OperationContractGenerationContext 方法的 IOperationContractGenerationExtension.GenerateOperation 对象可以在生成代码之前修改代码文档对象模型。 通常，System.ServiceModel.Description.IOperationContractGenerationExtension 接口是在自定义 System.ServiceModel.Description.IWsdlImportExtension 实现上实现的，该实现可用于导入自定义 WSDL 元素，或者在服务或操作级别修改代码。 若要在服务级别修改代码，请参见 System.ServiceModel.Description.IServiceContractGenerationExtension。

构造函数

OperationContractGenerationContext(ServiceContractGenerator, ServiceContractGenerationContext, OperationDescription, CodeTypeDeclaration, CodeMemberMethod)	使用指定的协定生成器、协定上下文、操作说明、代码类型声明、同步方法和任务方法初始化 OperationContractGenerationContext 类的新实例。
OperationContractGenerationContext(ServiceContractGenerator, ServiceContractGenerationContext, OperationDescription, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)	使用指定的协定生成器、协定上下文、操作说明、代码类型声明和方法初始化 OperationContractGenerationContext 类的新实例。
OperationContractGenerationContext(ServiceContractGenerator, ServiceContractGenerationContext, OperationDescription, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod, CodeMemberMethod)	初始化 OperationContractGenerationContext 类的新实例。
OperationContractGenerationContext(ServiceContractGenerator, ServiceContractGenerationContext, OperationDescription, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod, CodeMemberMethod, CodeMemberMethod)	使用指定的协定生成器、协定上下文、操作说明、代码类型声明、同步方法、开始方法和方法初始化 OperationContractGenerationContext 类的新实例。

属性

BeginMethod	获取异步开始操作的 CodeMemberMethod。
Contract	获取服务协定的代码生成上下文。
DeclaringType	获取当前操作的声明类型。
EndMethod	获取异步结束操作声明。
IsAsync	获取指示是否为当前操作生成异步方法的值。
IsTask	获取一个值，该值指示是否为当前操作生成一个任务。
Operation	获取当前操作的 OperationDescription。
ServiceContractGenerator	获取生成当前操作的 ServiceContractGenerator。
SyncMethod	获取同步操作的 CodeMemberMethod。
TaskMethod	获取任务操作的 CodeMemberMethod。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)