DataServiceConfiguration.SetEntitySetAccessRule Method

Sets the permissions for the specified entity set resource.

Namespace:  System.Data.Services
Assembly:  Microsoft.Data.Services (in Microsoft.Data.Services.dll)

Syntax

'Declaration
Public Sub SetEntitySetAccessRule ( _
    name As String, _
    rights As EntitySetRights _
)
'Usage
Dim instance As DataServiceConfiguration 
Dim name As String 
Dim rights As EntitySetRights

instance.SetEntitySetAccessRule(name, _
    rights)

public void SetEntitySetAccessRule(
    string name,
    EntitySetRights rights
)

public:
virtual void SetEntitySetAccessRule(
    String^ name, 
    EntitySetRights rights
) sealed

abstract SetEntitySetAccessRule : 
        name:string * 
        rights:EntitySetRights -> unit  
override SetEntitySetAccessRule : 
        name:string * 
        rights:EntitySetRights -> unit

public final function SetEntitySetAccessRule(
    name : String, 
    rights : EntitySetRights
)

Parameters

• name
  Type: System.String
  The Name of the entity set for which to set permissions.

• rights
  Type: System.Data.Services.EntitySetRights
  The Access rights to be granted to this resource, passed as an EntitySetRights value.

Implements

IDataServiceConfiguration.SetEntitySetAccessRule(String, EntitySetRights)

Remarks

When you specify a value of an asterisk (*) for the name parameter, permissions are set for all entity sets that do not have the permissions explicitly set.

Examples

This example shows the code-behind page for a Northwind-based data service, with access granted to selected entity sets.

Imports System.Data.Services
Imports System.Linq
Imports System.ServiceModel.Web

Public Class Northwind
    Inherits DataService(Of NorthwindEntities)

    ' This method is called only once to initialize service-wide policies.
    Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
        ' Grant only the rights needed to support the client application.
        config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead _
             Or EntitySetRights.WriteMerge _
             Or EntitySetRights.WriteReplace)
        config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead _
            Or EntitySetRights.AllWrite)
        config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead)
    End Sub
End Class

using System.Data.Services;
using System.Linq;
using System.ServiceModel.Web;

namespace NorthwindService
{
    [ServiceBehavior(IncludeExceptionDetailInFaults = true)]
    public class Northwind : DataService<NorthwindEntities>
    {
        // This method is called only once to initialize service-wide policies.
        public static void InitializeService(DataServiceConfiguration config)
        {
            // Grant only the rights needed to support the client application.
            config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead
                 | EntitySetRights.WriteMerge
                 | EntitySetRights.WriteReplace);
            config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead
                | EntitySetRights.AllWrite);
            config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead);
            config.DataServiceBehavior.MaxProtocolVersion =
                System.Data.Services.Common.DataServiceProtocolVersion.V3;
        }
    }
}

See Also

Reference

DataServiceConfiguration Class

System.Data.Services Namespace

Other Resources

Configuring the Data Service (WCF Data Services)