LanguagePreferences 类

提供针对语言具有服务实现的喜好支持。

此 API 不兼容 CLS。 兼容 CLS 的替代 API 为 [None]。

继承层次结构

System.Object
  Microsoft.VisualStudio.Package.LanguagePreferences

命名空间：  Microsoft.VisualStudio.Package
程序集：   Microsoft.VisualStudio.Package.LanguageService.10.0（在 Microsoft.VisualStudio.Package.LanguageService.10.0.dll 中）
  Microsoft.VisualStudio.Package.LanguageService.11.0（在 Microsoft.VisualStudio.Package.LanguageService.11.0.dll 中）
  Microsoft.VisualStudio.Package.LanguageService.9.0（在 Microsoft.VisualStudio.Package.LanguageService.9.0.dll 中）
  Microsoft.VisualStudio.Package.LanguageService（在 Microsoft.VisualStudio.Package.LanguageService.dll 中）

语法

声明
<CLSCompliantAttribute(False)> _
<GuidAttribute("934a92fd-b63a-49c7-9284-11aec8c1e03f")> _
<ComVisibleAttribute(True)> _
Public Class LanguagePreferences _
    Implements IVsTextManagerEvents2, IDisposable

[CLSCompliantAttribute(false)]
[GuidAttribute("934a92fd-b63a-49c7-9284-11aec8c1e03f")]
[ComVisibleAttribute(true)]
public class LanguagePreferences : IVsTextManagerEvents2, 
    IDisposable

LanguagePreferences 类型公开以下成员。

构造函数

	名称	说明
	LanguagePreferences()	初始化 LanguagePreferences 类 (仅默认初始化的新实例)。
	LanguagePreferences(IServiceProvider, Guid, String)	初始化 LanguagePreferences 类的新实例 (这是首选方法)。

页首

属性

	名称	说明
	AutoListMembers	获取或设置成员是否自动列表用作 IntelliSense 一部分支持。
	AutoOutlining	获取或设置自动大纲显示是否支持的大纲 (这需要分析器的隐藏区域支持)。
	CodeSenseDelay	获取或设置用户必须在启动任何 IntelliSense 操作之前保持标识符的光标毫秒数。
	CutCopyBlankLines	，在剪辑以及复制时，获取或设置是否包括在空白行留出空间。
	EnableAsyncCompletion	，如果分析的背景支持，则获取或设置。
	EnableCodeSense	获取或设置是否支持 IntelliSense。
	EnableCommenting	获取或设置是否代码块中注释和 uncommented。
	EnableFormatSelection	获取或设置代码是否可以进行格式设置。
	EnableLeftClickForURLs	获取或设置在代码的 URL 是否可以导航到简单中单击。
	EnableMatchBraces	获取或设置匹配的大括号是否支持。
	EnableMatchBracesAtCaret	获取或设置匹配的大括号是否可以显示，当键入匹配的大括号时。
	EnableQuickInfo	获取或设置 IntelliSense 快速信息 操作是否支持。
	EnableShowMatchingBrace	获取或设置在范围包含的文本是否在状态栏相对显示。
	HideAdvancedMembers	获取或设置高级成员是否在 IntelliSense 成员隐藏列表。
	HighlightMatchingBraceFlags	获取或设置显示匹配的大括号标志。
	IndentSize	，在设置源时，获取或设置空格数缩进。
	IndentStyle	获取或设置用于格式化文本的部分使用的样式。
	InsertTabs	，在设置文本的部分时，获取或设置是否插入选项而不是空格。
	LanguageName	获取或设置语言服务注册下的名称。
	LineNumbers	获取或设置行号是否将显示。
	MaxErrorMessages	获取或设置的错误消息的最大数可以随时显示。
	MaxRegionTime	获取或设置最大界限时。
	ParameterInformation	获取或设置 IntelliSense 方法提示操作是否支持。
	ShowNavigationBar	获取或设置下拉栏是否将显示。
	Site	获取或设置服务提供程序。
	TabSize	获取或设置空格数单个可选说明。
	VirtualSpace	获取或设置编辑器是否应该假定空间在所有行的结尾。
	WordWrap	获取或设置的包装是否启用。
	WordWrapGlyphs	获取或设置是否应针对个换行显示标志符号。

页首

方法

	名称	说明
	Apply	应用所做的任何更改为首选项。
	Dispose	，在销毁之前，会清除所有已分配的资源对象。
	Equals	确定指定的对象是否等于当前对象。 （继承自 Object。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。）
	GetBooleanValue	从指定的注册表项的布尔值。
	GetHashCode	用作特定类型的哈希函数。 （继承自 Object。）
	GetIntegerValue	从指定的注册表项获取整数值。
	GetLanguagePreferences	从 Visual Studio 获取可修改的用户语言设置。
	GetSite	获取服务提供程序。
	GetType	获取当前实例的 Type。 （继承自 Object。）
	Init	初始化 LanguagePreferences。
	InitMachinePreferences	从注册表中获取语言服务具有特定的设置。
	InitUserPreferences	获取用户可修改的设置。
	MemberwiseClone	创建当前 Object 的浅表副本。 （继承自 Object。）
	OnRegisterMarkerType	调用，则新的标记类型移到 Visual Studio注册。
	OnRegisterView	调用时，视图注册。
	OnReplaceAllInFilesBegin	调用，在文件操作的替换整个启动。
	OnReplaceAllInFilesEnd	调用，在文件操作的替换整个关闭。
	OnUnregisterView	调用时，视图是关闭。
	OnUserPreferencesChanged2	调用，更改了用户首选项。
	ToString	返回表示当前对象的字符串。 （继承自 Object。）

页首

备注

基类管理首选项特定于语言服务以及用户可以从 工具 的一般首选项 - AMP_GT 选项 影响 - AMP_GT 文本编辑器 类别。

以下注册表项特定于语言服务和方面反映在基类的属性。这些注册表项在注册表项 HKEY_LOCAL_MACHINE \ \SOFTWARE\Microsoft\VisualStudioX.Y\Languages\Language Services \Language Name存储。

X.Y 是 Visual Studio 的版本 (例如， 8.0 或 8.0Exp)。

Language Name 是该语言的名称。

注册表项	类型	值	说明
CodeSense	DWORD	AMP_LT0 或 1AMP_GT	1 指示为 IntelliSense 支持。
MatchBraces	DWORD	AMP_LT0 或 1AMP_GT	1 指示用于匹配的大括号支持。
快速信息	DWORD	AMP_LT0 或 1AMP_GT	1 指示为 快速信息 IntelliSense 操作的支持。
ShowMatchingBraces	DWORD	AMP_LT0 或 1AMP_GT	1 指示在范围包含的文本在状态栏相对语言元素显示。
MatchBracesAtCaret	DWORD	AMP_LT0 或 1AMP_GT	1 指示匹配的大括号可以显示，当键入匹配的大括号时。
MaxErrorMessages	DWORD	number	的错误消息的最大数可以将其置于从该分析器的 错误表选项 窗口。
CodeSenseDelay	DWORD	number	时间 (以毫秒为用户必须在触发 IntelliSense 操作之前保持标识符的光标。
EnableAsyncCompletion	DWORD	AMP_LT0 或 1AMP_GT	1 指示为异步或后台分析支持。
EnableCommenting	DWORD	AMP_LT0 或 1AMP_GT	1 指示为单个操作的注释和取消注释代码的支持。
EnableFormatSelection	DWORD	AMP_LT0 或 1AMP_GT	1 指示为格式化源文本支持。
AutoOutlining	DWORD	AMP_LT0 或 1AMP_GT	1 指示为自动大纲显示支持 (这需要分析器的隐藏区域支持)。
MaxRegions	DWORD	number	在单个文件中处理隐藏的区域的最大数目。

对实现者的说明

如果有任何语言特定的属性除基类中支持的参数以外，必须从 LanguagePreferences 派生类并从 GetLanguagePreferences 方法返回类的实例。请确保在返回语言首选项实例之前调用 Initialize 方法。此外，还必须重写 InitUserPreferences、 OnUserPreferencesChanged2和 Apply 方法支持访问指定的属性。

假定， LanguagePreferences 单个对象实例用于语言服务进行维护。这样，用户对这些特性进行任何更改动态更新在首选项和因此，在语言服务中。

对调用者的说明

此类的实例从 LanguageService 方法 GetLanguagePreferences返回。许多属性引用在语言服务类中的托管包 framework 版本。

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.Package 命名空间