WsdlContractConversionContext.GetOperation(OperationDescription) Метод

Определение

Пространство имен:

System.ServiceModel.Description

Сборка:

System.ServiceModel.dll

Возвращает операцию для указанного описания операции.

public:
 System::Web::Services::Description::Operation ^ GetOperation(System::ServiceModel::Description::OperationDescription ^ operation);

public System.Web.Services.Description.Operation GetOperation (System.ServiceModel.Description.OperationDescription operation);

member this.GetOperation : System.ServiceModel.Description.OperationDescription -> System.Web.Services.Description.Operation

Public Function GetOperation (operation As OperationDescription) As Operation

Параметры

operation

OperationDescription

Объект OperationDescription для запрошенного Operation.

Возвращаемое значение

Operation

Операция для указанного описания операции.

Исключения

KeyNotFoundException

Значение не найдено.

ArgumentNullException

Значение — null.

Примеры

В следующем примере кода показано использование объекта WsdlContractConversionContext для добавления пользовательских примечаний WSDL к экспортируемым метаданным с использованием свойства WsdlPortType и свойства Contract. При экспорте операций этот метод выполняет перебор описаний операций и находит каждую связанную операцию System.Web.Services.Description.Operation путем вызова метода GetOperation.

Console.WriteLine("Inside ExportContract");
if (context.Contract != null)
{
    // Inside this block it is the contract-level comment attribute.
    // This.Text returns the string for the contract attribute.
    // Set the doc element; if this isn't done first, there is no XmlElement in the
    // DocumentElement property.
    context.WsdlPortType.Documentation = string.Empty;
    // Contract comments.
    XmlDocument owner = context.WsdlPortType.DocumentationElement.OwnerDocument;
    XmlElement summaryElement = Formatter.CreateSummaryElement(owner, this.Text);
    context.WsdlPortType.DocumentationElement.AppendChild(summaryElement);

    foreach (OperationDescription op in context.Contract.Operations)
    {
        Operation operation = context.GetOperation(op);
        object[] opAttrs = op.SyncMethod.GetCustomAttributes(typeof(WsdlDocumentationAttribute), false);
        if (opAttrs.Length == 1)
        {
            string opComment = ((WsdlDocumentationAttribute)opAttrs[0]).Text;

            // This.Text returns the string for the operation-level attributes.
            // Set the doc element; if this isn't done first, there is no XmlElement in the
            // DocumentElement property.
            operation.Documentation = String.Empty;

            // Operation C# triple comments.
            XmlDocument opOwner = operation.DocumentationElement.OwnerDocument;
            XmlElement newSummaryElement = Formatter.CreateSummaryElement(opOwner, opComment);
            operation.DocumentationElement.AppendChild(newSummaryElement);

            // Get returns information
            ParameterInfo returnValue = op.SyncMethod.ReturnParameter;
            object[] returnAttrs = returnValue.GetCustomAttributes(typeof(WsdlParameterDocumentationAttribute), false);
            if (returnAttrs.Length == 1)
            {
                // <returns>text.</returns>
                XmlElement returnsElement =
                  Formatter.CreateReturnsElement(
                    opOwner,
                    ((WsdlParameterDocumentationAttribute)returnAttrs[0]).ParamComment
                  );
                operation.DocumentationElement.AppendChild(returnsElement);
            }

            // Get parameter information.
            ParameterInfo[] args = op.SyncMethod.GetParameters();
            for (int i = 0; i < args.Length; i++)
            {
                object[] docAttrs
                  = args[i].GetCustomAttributes(typeof(WsdlParameterDocumentationAttribute), false);
                if (docAttrs.Length != 0)
                {
                    // <param name="Int1">Text.</param>
                    XmlElement newParamElement = opOwner.CreateElement("param");
                    XmlAttribute paramName = opOwner.CreateAttribute("name");
                    paramName.Value = args[i].Name;
                    newParamElement.InnerText
                      = ((WsdlParameterDocumentationAttribute)docAttrs[0]).ParamComment;
                    newParamElement.Attributes.Append(paramName);
                    operation.DocumentationElement.AppendChild(newParamElement);
                }
            }
        }
    }
}