ServiceContractGenerationContext Classe

Definição

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Passado para o método GenerateContract(ServiceContractGenerationContext) para habilitar a modificação de um contrato de serviço e seu contexto antes de gerar código.

public ref class ServiceContractGenerationContext

public class ServiceContractGenerationContext

type ServiceContractGenerationContext = class

Public Class ServiceContractGenerationContext

Herança

Object

ServiceContractGenerationContext

Exemplos

O exemplo a seguir mostra o uso do ServiceContractGenerationContext objeto passado para o IServiceContractGenerationExtension.GenerateContract método para adicionar comentários de código extraídos de elementos WSDL personalizados.

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

O exemplo de código a seguir mostra os comentários de código resultantes.

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

Comentários

Use o ServiceContractGenerationContext objeto passado para o IServiceContractGenerationExtension.GenerateContract método para modificar o modelo de objeto do documento de código antes da geração de código. Normalmente, a System.ServiceModel.Description.IServiceContractGenerationExtension interface é implementada em uma implementação personalizada System.ServiceModel.Description.IWsdlImportExtension que é usada para importar elementos WSDL personalizados ou modificar o código no nível do serviço ou da operação. Para modificar o código no nível da operação, consulte System.ServiceModel.Description.IOperationContractGenerationExtension.

Construtores

ServiceContractGenerationContext(ServiceContractGenerator, ContractDescription, CodeTypeDeclaration)	Inicializa uma nova instância da classe ServiceContractGenerationContext usando o gerador de contrato especificado, a descrição do contrato e a declaração de tipo de código do contrato.
ServiceContractGenerationContext(ServiceContractGenerator, ContractDescription, CodeTypeDeclaration, CodeTypeDeclaration)	Inicializa uma nova instância da classe ServiceContractGenerationContext usando o gerador de contrato especificado, a descrição do contrato e a declaração de tipo de código do contrato.

Propriedades

Contract	Obtém o ContractDescription do contrato atual.
ContractType	Obtém o CodeTypeDeclaration do contrato atual.
DuplexCallbackType	Obtém o CodeTypeDeclaration do contrato do retorno de chamada duplex no contrato de serviço.
Operations	Obtém uma coleção de objetos OperationContractGenerationContext que representam as operações de contrato.
ServiceContractGenerator	Obtém o ServiceContractGenerator que deverá gerar o contrato.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)