ServiceContractGenerationContext 類別

定義

命名空間:

System.ServiceModel.Description

組件:

System.ServiceModel.dll

傳遞至 GenerateContract(ServiceContractGenerationContext) 方法，在產生程式碼之前啟用服務合約和其內容的修改。

public ref class ServiceContractGenerationContext

public class ServiceContractGenerationContext

type ServiceContractGenerationContext = class

Public Class ServiceContractGenerationContext

繼承

Object

ServiceContractGenerationContext

範例

下列範例將示範如何使用傳遞給 ServiceContractGenerationContext 方法的 IServiceContractGenerationExtension.GenerateContract 物件，以便加入從自訂 WSDL 項目擷取而來的程式碼註解。

public void GenerateContract(ServiceContractGenerationContext context)
{
  Console.WriteLine("In generate contract.");
  context.ContractType.Comments.AddRange(Formatter.FormatComments(commentText));
}

下列程式碼範例將示範所產生的程式碼註解。

/// 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

備註

您可以使用傳遞至 ServiceContractGenerationContext 方法的 IServiceContractGenerationExtension.GenerateContract 物件，在程式碼產生之前修改程式碼文件物件模型。 一般而言，會在 System.ServiceModel.Description.IServiceContractGenerationExtension 自訂實作 (用來在服務或作業層級匯入自訂 WSDL 項目或修改程式碼) 上實作 System.ServiceModel.Description.IWsdlImportExtension 介面。 如果要在作業層級修改程式碼，請參閱 System.ServiceModel.Description.IOperationContractGenerationExtension。

建構函式

ServiceContractGenerationContext(ServiceContractGenerator, ContractDescription, CodeTypeDeclaration)	使用指定的合約產生器、合約描述和合約程式碼型別宣告，初始化 ServiceContractGenerationContext 類別的新執行個體。
ServiceContractGenerationContext(ServiceContractGenerator, ContractDescription, CodeTypeDeclaration, CodeTypeDeclaration)	使用指定的合約產生器、合約描述和合約程式碼型別宣告，初始化 ServiceContractGenerationContext 類別的新執行個體。

屬性

Contract	取得目前合約的 ContractDescription。
ContractType	取得目前合約的 CodeTypeDeclaration。
DuplexCallbackType	取得服務合約上雙工回呼合約的 CodeTypeDeclaration。
Operations	取得表示合約作業的 OperationContractGenerationContext 物件的集合。
ServiceContractGenerator	取得要產生合約的 ServiceContractGenerator。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)