DataServiceConfiguration-Klasse

Verwaltet die Konfiguration von WCF Data Services.

Vererbungshierarchie

System.Object
  System.Data.Services.DataServiceConfiguration

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

Syntax

'Declaration
Public NotInheritable Class DataServiceConfiguration _
    Implements IDataServiceConfiguration
'Usage
Dim instance As DataServiceConfiguration

public sealed class DataServiceConfiguration : IDataServiceConfiguration

public ref class DataServiceConfiguration sealed : IDataServiceConfiguration

[<SealedAttribute>]
type DataServiceConfiguration =  
    class
        interface IDataServiceConfiguration
    end

public final class DataServiceConfiguration implements IDataServiceConfiguration

Der DataServiceConfiguration-Typ macht folgende Elemente verfügbar.

Eigenschaften

	Name	Beschreibung
	AnnotationsBuilder	Erstellt die Anmerkungsmodelle, die auf das Datenmodell des Anbieters angewendet werden sollen.
	DataServiceBehavior	Ruft ein DataServiceBehavior-Objekt ab, das die zusätzlichen Verhaltensweisen des Datendiensts definiert.
	DisableValidationOnMetadataWrite	Ruft ab oder legt fest, ob das Datenmodell überprüft wird, bevor es als Antwort auf eine Anfrage an den $metadata-Endpunkt ausgegeben wird.
	EnableTypeConversion	Ruft ab oder legt fest, ob die Datendienstlaufzeit den in der Nutzlast enthaltenen Typ in den in der Anforderung angegebenen tatsächlichen Eigenschaftstyp konvertieren soll.
	MaxBatchCount	Ruft die maximale Anzahl von Changesets und Abfragevorgängen, die in einem einzelnen Batch zulässig sind, ab oder legt sie fest.
	MaxChangesetCount	Ruft die maximale Anzahl von Änderungen, die in einem einzelnen Changeset enthalten sein können, ab oder legt sie fest.
	MaxExpandCount	Ruft die maximale Anzahl von verknüpften Entitäten, die mit dem $expand-Operator in einer einzelnen Anforderung enthalten sein können, ab oder legt sie fest.
	MaxExpandDepth	Ruft die maximale Anzahl von verknüpften Entitäten, die in einem $expand-Pfad in einer einzelnen Anforderung enthalten sein können, ab oder legt sie fest.
	MaxObjectCountOnInsert	Ruft die maximale Anzahl von einzufügenden Objekten, die in einer einzelnen POST-Anforderung enthalten sein können, ab oder legt sie fest.
	MaxResultsPerCollection	Ruft die maximale Anzahl von Elementen in jeder zurückgegebenen Auflistung ab oder legt sie fest.
	UseVerboseErrors	Ruft ab oder legt fest, ob ausführliche Fehler vom Datendienst zurückgegeben werden sollen.

Zum Anfang

Methoden

	Name	Beschreibung
	EnableTypeAccess	Registriert einen Datentyp bei der Datendienstlaufzeit, damit er von einem benutzerdefinierten Datendienstanbieter verwendet werden kann.
	Equals	(Geerbt von Object.)
	Finalize	(Geerbt von Object.)
	GetHashCode	(Geerbt von Object.)
	GetType	(Geerbt von Object.)
	MemberwiseClone	(Geerbt von Object.)
	RegisterKnownType	Fügt der Liste der vom Datendienst erkannten Typen einen Typ hinzu.
	SetEntitySetAccessRule	Legt die Berechtigungen für die angegebene Entitätenmengenressource fest.
	SetEntitySetPageSize	Legt die maximale Seitengröße für eine Entitätenmengenressource fest.
	SetServiceActionAccessRule	Legt die Berechtigungen für die angegebene Dienstaktion fest.
	SetServiceOperationAccessRule	Legt die Berechtigungen für den angegebenen Dienstvorgang fest.
	ToString	(Geerbt von Object.)

Zum Anfang

Beispiele

In diesem Beispiel wird die Code-Behind-Seite für einen Northwind-basierten Datendienst veranschaulicht, wobei Zugriff auf ausgewählte Entitätenmengen gewährt wird.

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;
        }
    }
}

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

System.Data.Services-Namespace

Andere Ressourcen

Konfigurieren des Datendiensts (WCF Data Services)