DataServiceConfiguration.EnableTypeAccess(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向数据服务运行时注册数据类型,使得该数据类型可供自定义数据服务提供程序使用。
public:
void EnableTypeAccess(System::String ^ typeName);
public void EnableTypeAccess (string typeName);
member this.EnableTypeAccess : string -> unit
Public Sub EnableTypeAccess (typeName As String)
参数
- typeName
- String
启用后能够用于自定义数据服务提供程序的类型的命名空间限定名称。
注解
EnableTypeAccess 方法用于向数据服务运行时注册类型。 注册后,该类型可以在开放类型的属性中返回。 这使得类型在输出中 $metadata
可见,并可由数据服务使用。
必须将提供的 typeName
定义为与数据模型中的类型采用相同的格式,而不是采用与 CLR 类型相同的格式。 注册的类型将添加到已通过调用 SetEntitySetAccessRule 方法来提供的类型中。
数据服务运行时不能确定 typeName
映射到哪种数据类型,直到可从基础提供程序获得有关类型的信息。
可向 typeName
提供匹配所有类型的“*”值。
当数据服务运行时枚举类型,或必须从基础数据提供程序获取一个类型时,它必须首先确定调用 SetEntitySetAccessRule 方法时该类型是否必须可见。 当无法通过这种方式提供类型时,则可以检查使用 EnableTypeAccess 方法注册的类型。 如果通过使用这两种机制之一使类型不可见,该类型不会包含在对 $metadata
请求的响应中,并且该类型的实例不会作为对数据服务的请求的响应返回到客户端。
可以使用同一类型名称多次调用 EnableTypeAccess 方法。