ILanguageClient インターフェイス

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

言語サーバープロトコルベースの言語サーバーに接続する言語クライアントを表すインターフェイス。

public interface class ILanguageClient

public interface ILanguageClient

type ILanguageClient = interface

Public Interface ILanguageClient

の通常のアクティブ化シーケンスは、次の ILanguageClient パターンに従います。

Visual Studio は、を呼び出します OnLoadedAsync()。
拡張機能は、からOnLoadedAsync()戻る前にイベントをStartAsync呼び出して待機しますInvokeAsync<TEventArgs>(AsyncEventHandler<TEventArgs>, Object, TEventArgs)。
から戻る前に Visual Studio が ActivateAsync(CancellationToken) を呼び出して待機します OnLoadedAsync()。
拡張機能は LSP サーバーを起動し、を Visual Studio に返します Connection 。
Visual Studio は、"initialize" および "initialize" LSP メッセージを使用してサーバーの非同期初期化を開始します。
Visual Studio でイベント処理が完了します StartAsync 。
拡張機能によって実行が完了します OnLoadedAsync() 。
Visual Studio は、"initialize" メッセージと "initialize" LSP メッセージが交換された後 (または失敗した場合はメソッド) の後にメソッドをOnServerInitializeFailedAsync(ILanguageClientInitializationInfo)呼び出OnServerInitializedAsync()します。

ConfigurationSections	言語クライアントの構成セクション名を取得します。言語クライアントが設定を提供しない場合、これは null になる可能性があります。
FilesToWatch	変更をwatchするファイル名の一覧を取得します。変更は、'workspace/didChangeWatchedFiles' メッセージを介してサーバーに送信されます。 watchするファイルは、現在アクティブなワークスペースの下にある必要があります。ファイル名は、正確なファイルへの相対パスとして指定することも、.gitignore の標準に従う glob パターンとしてファイルを参照することもできます https://www.kernel.org/pub/software/scm/git/docs/gitignore.html 。
InitializationOptions	"initialize" メッセージの送信時にクライアントが送信する初期化オプションオブジェクトを取得します。クライアントがカスタム初期化オプションを必要としない場合、これは null になる可能性があります。
Name	言語クライアントの名前を取得します (ユーザーに表示されます)。
ShowNotificationOnInitializeFailed	言語サーバーの初期化に失敗したときに通知バブルショーを表示するかどうかを示す値を取得します。

ActivateAsync(CancellationToken)	このメソッドは、LSP サーバーを起動する必要があることを拡張機能に通知するために Visual Studio によって呼び出されます。
OnLoadedAsync()	このメソッドは、言語クライアントが読み込まれたことを拡張機能に通知するために Visual Studio によって呼び出されます。拡張機能は、LSP サーバーをすぐに起動するか、ユーザーの操作が開始されるのを待つことができます。サーバー呼び出しを開始し、このメソッドから戻る前に StartAsync イベントを待機InvokeAsync<TEventArgs>(AsyncEventHandler<TEventArgs>, Object, TEventArgs)します。
OnServerInitializedAsync()	このメソッドは、LSP サーバーが初期化されたことを拡張機能に通知するために Visual Studio によって呼び出されます。LSP "initialize" メッセージと "initialize" メッセージが交換されました。
OnServerInitializeFailedAsync(Exception)	言語サーバーの初期化に失敗したことを拡張機能に通知します。
OnServerInitializeFailedAsync(ILanguageClientInitializationInfo)	このメソッドは、LSP サーバーの初期化に失敗したことを拡張機能に通知するために Visual Studio によって呼び出されます。

StartAsync	を呼び出 ActivateAsync(CancellationToken)してサーバーを起動する必要があることを Visual Studio に示す非同期イベント。サーバーが既に起動されている場合、このイベントは無視されます。
StopAsync	LSP "シャットダウン" 要求を送信してサーバーを停止する必要があることを Visual Studio に示す非同期イベント。サーバーが起動されていない場合、このイベントは無視されます。