ISettingsManager.GetOrCreateList(String, Boolean) 方法

  • 参考

定义

命名空间:
Microsoft.VisualStudio.Settings
程序集:
Microsoft.VisualStudio.Utilities.dll
程序集:

检索现有列表，如果不存在具有指定名称的列表，则创建一个新列表。

public:
 Microsoft::VisualStudio::Settings::ISettingsList ^ GetOrCreateList(System::String ^ name, bool isMachineLocal);
public:
 Microsoft::VisualStudio::Settings::ISettingsList ^ GetOrCreateList(Platform::String ^ name, bool isMachineLocal);
Microsoft::VisualStudio::Settings::ISettingsList GetOrCreateList(std::wstring const & name, bool isMachineLocal);
public Microsoft.VisualStudio.Settings.ISettingsList GetOrCreateList (string name, bool isMachineLocal);
abstract member GetOrCreateList : string * bool -> Microsoft.VisualStudio.Settings.ISettingsList
Public Function GetOrCreateList (name As String, isMachineLocal As Boolean) As ISettingsList

参数

name
String

设置的名称。

isMachineLocal
Boolean

如果设置为本地计算机，则为 True; 否则为 false。

返回

ISettingsList

返回 ISettingsList。

例外

ArgumentNullException

当 name 为 null 时引发。

ArgumentException

当 name 为空时引发。

IOException

当空列表无法保存到专用存储区时引发 (例如，因为磁盘已满) 。

SettingNameTooLongException

name超出允许的最大长度时引发。

注解

对于列表，使用特殊的 "获取" 或 "创建" 方法的原因 (而不是让客户端将 IEnumerable 传递到 SetValue 来创建列表) 是避免两个客户端之间出现争用条件，这两个客户端同时同时构成列表 "脱机"。 这要求客户端将两个列表内容 (合并，或者放弃一个) 列表。 通过要求客户端改为使用此方法，我们确保列表始终为 "实时"，永远不会 "脱机"，因此，一旦一位客户端开始向列表中添加内容，该内容将对所有其他客户端可见。

适用于