检索与指定的DDEX提供程序和连接信息的数据视图层次结构。
命名空间: Microsoft.VisualStudio.Data
程序集: Microsoft.VisualStudio.Data(在 Microsoft.VisualStudio.Data.dll 中)
语法
声明
Public Function GetDataViewHierarchy ( _
provider As Guid, _
connectionString As String, _
encryptedString As Boolean _
) As Object
public Object GetDataViewHierarchy(
Guid provider,
string connectionString,
bool encryptedString
)
public:
Object^ GetDataViewHierarchy(
Guid provider,
String^ connectionString,
bool encryptedString
)
member GetDataViewHierarchy :
provider:Guid *
connectionString:string *
encryptedString:bool -> Object
public function GetDataViewHierarchy(
provider : Guid,
connectionString : String,
encryptedString : boolean
) : Object
参数
- provider
类型:System.Guid
DDEX提供程序的标识符。
- connectionString
类型:System.String
包含连接信息的一个未加密或加密字符串。
- encryptedString
类型:System.Boolean
指示 connectionString 参数是否已加密。
返回值
类型:System.Object
返回与指定的DDEX提供程序和连接信息的数据视图层次结构。
异常
异常 | 条件 |
---|---|
ArgumentNullException | connectionString 参数为 null。 |
ArgumentException | 一个指定的提供程序不是一个注册的DDEX提供程序。 |
备注
如果存在两个连接信息查看层次结构等效于传递的信息,方法返回现有数据视图层次结构。否则,新的数据视图层次结构中创建。
此层次结构的创建可能导致连接中打开以生成层次结构根节点的名称。若要避免打开连接,请调用另一个 GetDataViewHierarchy 方法,按 name 参数的非nullnull 引用(在 Visual Basic 中为 Nothing) 值。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。