
Indicates a service operation is logically an invoke operation and that it can be called by the REST programming model.
Assembly: System.ServiceModel.Web (in System.ServiceModel.Web.dll)
The WebInvokeAttribute attribute is applied to a service operation in addition to the OperationContractAttribute and associates the operation with a UriTemplate as well as an underlying transport verb that represents an invocation (for example, HTTP POST, PUT, or DELETE). The WebInvokeAttribute attribute is a passive operation behavior (the IOperationBehavior methods do nothing) that adds metadata to the operation description. Applying the WebInvokeAttribute attribute to a service operation has no effect unless a behavior that looks for this metadata in the operation description (such as WebHttpBehavior) is added to the service's behavior collection. The WebInvokeAttribute determines what HTTP method that a service operation responds to. By default, all methods that have the WebInvokeAttribute applied respond to POST requests. The Method property allows you to specify a different HTTP method. If you want a service operation to respond to GET, use the WebGetAttribute instead.
The following example shows how to use the WebInvokeAttribute attribute.
Note |
|---|
Because the Method property is not specified in the following code, all service operations are mapped to the HTTP POST method. |
<ServiceContract()> _ Public Interface ICalculator2 <OperationContract()> _ <WebInvoke()> _ Function Add(ByVal x As Long, ByVal y As Long) As Long <OperationContract()> _ <WebInvoke(UriTemplate:="Sub?x={x}&y={y}")> _ Function Subtract(ByVal x As Long, ByVal y As Long) As Long <OperationContract()> _ <WebInvoke(UriTemplate:="Mult?x={x}&y={y}", BodyStyle:=WebMessageBodyStyle.Bare)> _ Function Multiply(ByVal x As Long, ByVal y As Long) As Long <OperationContract()> _ <WebInvoke(UriTemplate:="Div?x={x}&y={y}", BodyStyle:=WebMessageBodyStyle.Bare, RequestFormat:=WebMessageFormat.Xml, ResponseFormat:=WebMessageFormat.Xml)> _ Function Divide(ByVal x As Long, ByVal y As Long) As Long <OperationContract()> _ <WebInvoke(Method:="POST", UriTemplate:="Mod?x={x}&y={y}")> _ Function Modulo(ByVal x As Long, ByVal y As Long) As Long End Interface
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.