Окно вывода (Visual Studio)
Вывод окно набор панелей текст, с помощью которого можно записывать и считывать. Visual Studio определяет встроенные панели: Построениедо, проекты, взаимодействуют сообщения о построениях и Общие, через который Visual Studio передает сообщения об интегрированной среде разработки (ide). Получает ссылку на проекты Построение автоматически через панель IVsBuildableProjectCfg методы интерфейса и Visual Studio обеспечивает прямой доступ к Общие панель посредством SVsGeneralOutputWindowPane служба. В дополнение к встроенным панели можно создавать и управлять собственные настраиваемые панели.
Можно вести наблюдение Вывод непосредственно через окно IVsOutputWindow и IVsOutputWindowPane интерфейсы. IVsOutputWindow интерфейс, который предложен SVsOutputWindow служба определяет методы для создания, получение и разрушать Вывод области окна. IVsOutputWindow интерфейс определяет методы для отображения панели скрыть панель и управлять их текста. Альтернативный способ мониторинга Вывод окно с помощью OutputWindow и OutputWindowPane объекты в объектной модели автоматизации Visual Studio. Эти объекты инкапсулируют почти все функциональные возможности IVsOutputWindow и IVsOutputWindowPane интерфейсы. Кроме того, OutputWindow и OutputWindowPane объекты добавить некоторые функции более высокого уровня для упрощает перечисления Вывод области окна и извлечение текста из панелей.
Пример
Описание
В этом примере демонстрируется создание новой Вывод область окна с помощью IVsOutputWindow интерфейс.
Код
Private Function CreatePane(ByVal paneGuid As Guid, ByVal title As String, ByVal visible As Boolean, ByVal clearWithSolution As Boolean) As IVsOutputWindowPane
Dim output As IVsOutputWindow = DirectCast(GetService(GetType(SVsOutputWindow)), IVsOutputWindow)
Dim pane As IVsOutputWindowPane
' Create a new pane.
output.CreatePane(paneGuid, title, Convert.ToInt32(visible), Convert.ToInt32(clearWithSolution))
' Retrieve the new pane.
output.GetPane(paneGuid, pane)
Return pane
End Function
IVsOutputWindowPane CreatePane(Guid paneGuid, string title,
bool visible, bool clearWithSolution)
{
IVsOutputWindow output =
(IVsOutputWindow)GetService(typeof(SVsOutputWindow));
IVsOutputWindowPane pane;
// Create a new pane.
output.CreatePane(
ref paneGuid,
title,
Convert.ToInt32(visible),
Convert.ToInt32(clearWithSolution));
// Retrieve the new pane.
output.GetPane(ref paneGuid, out pane);
return pane;
}
Пример
Описание
В этом примере показано, как создать Вывод область окна с помощью OutputWindow объект.
Код
Private Function CreatePane(ByVal title As String) As OutputWindowPane
Dim dte As DTE2 = DirectCast(GetService(GetType(DTE)), DTE2)
Dim panes As OutputWindowPanes = dte.ToolWindows.OutputWindow.OutputWindowPanes
Try
' If the pane exists already, return it.
Return panes.Item(title)
Catch generatedExceptionName As ArgumentException
' Create a new pane.
Return panes.Add(title)
End Try
End Function
OutputWindowPane CreatePane(string title)
{
DTE2 dte = (DTE2)GetService(typeof(DTE));
OutputWindowPanes panes =
dte.ToolWindows.OutputWindow.OutputWindowPanes;
try
{
// If the pane exists already, return it.
return panes.Item(title);
}
catch (ArgumentException)
{
// Create a new pane.
return panes.Add(title);
}
}
Комментарии
Как OutputWindowPanes коллекция позволяет извлекать Вывод нет гарантии, что область окна своим именем заголовка панели уникальным. При сомневаетесь уникальность имени, используйте GetPane метод для извлечения правая панель его идентификатора GUID.
Пример
Описание
В этом примере показано, как удалять Вывод область окна.
Код
Private Sub DeletePane(ByVal paneGuid As Guid)
Dim output As IVsOutputWindow = DirectCast(GetService(GetType(SVsOutputWindow)), IVsOutputWindow)
output.DeletePane(paneGuid)
End Sub
void DeletePane(Guid paneGuid)
{
IVsOutputWindow output =
(IVsOutputWindow)GetService(typeof(SVsOutputWindow));
output.DeletePane(ref paneGuid);
}
Пример
Описание
В этом примере показано, как удалять Вывод область окна, получая OutputWindowPane объект.
Код
Private Sub DeletePane(ByVal pane As OutputWindowPane)
Dim output As IVsOutputWindow = DirectCast(GetService(GetType(SVsOutputWindow)), IVsOutputWindow)
Dim paneGuid As New Guid(pane.Guid)
output.DeletePane(paneGuid)
End Sub
void DeletePane(OutputWindowPane pane)
{
IVsOutputWindow output =
(IVsOutputWindow)GetService(typeof(SVsOutputWindow));
Guid paneGuid = new Guid(pane.Guid);
output.DeletePane(ref paneGuid);
}
Пример
Описание
В этом примере показано, как получить встроенное Общие панель Вывод окна.
Код
Private Function GetGeneralPane() As IVsOutputWindowPane
Return DirectCast(GetService(GetType(SVsGeneralOutputWindowPane)), IVsOutputWindowPane)
End Function
IVsOutputWindowPane GetGeneralPane()
{
return (IVsOutputWindowPane)GetService(
typeof(SVsGeneralOutputWindowPane));
}
Пример
Описание
В этом примере показано, как анализировать стандартное сообщение построения для ошибок, а также добавляет элемент к ошибка окно, при необходимости, до того как сообщение отправляется Вывод окна.
Код
Private Sub OutputTaskItemStringExExample(ByVal buildMessage As String, ByVal buildPane As IVsOutputWindowPane, ByVal launchPad As IVsLaunchPad)
Dim priority As UInteger() = New UInteger(0) {}, lineNumber As UInteger() = New UInteger(0) {}
Dim fileName As String() = New String(0) {}, taskItemText As String() = New String(0) {}
Dim taskItemFound As Integer() = New Integer(0) {}
' Determine whether buildMessage contains an error.
launchPad.ParseOutputStringForTaskItem(buildMessage, priority, fileName, lineNumber, taskItemText, taskItemFound)
' If buildMessage contains an error, send it to both the
' Error window and the Output window; otherwise, send it
' to the Output window only.
If taskItemFound(0) <> 0 Then
buildPane.OutputTaskItemStringEx(buildMessage, DirectCast(priority(0), VSTASKPRIORITY), VSTASKCATEGORY.CAT_BUILDCOMPILE, Nothing, 0, fileName(0), _
lineNumber(0), taskItemText(0), Nothing)
Else
buildPane.OutputString(buildMessage)
End If
buildPane.OutputString(vbLf)
End Sub
void OutputTaskItemStringExExample(string buildMessage,
IVsOutputWindowPane buildPane, IVsLaunchPad launchPad)
{
uint[] priority = new uint[1], lineNumber = new uint[1];
string[] fileName = new string[1], taskItemText = new string[1];
int[] taskItemFound = new int[1];
// Determine whether buildMessage contains an error.
launchPad.ParseOutputStringForTaskItem(
buildMessage,
priority,
fileName,
lineNumber,
taskItemText,
taskItemFound);
// If buildMessage contains an error, send it to both the
// Error window and the Output window; otherwise, send it
// to the Output window only.
if (taskItemFound[0] != 0)
{
buildPane.OutputTaskItemStringEx(
buildMessage,
(VSTASKPRIORITY)priority[0],
VSTASKCATEGORY.CAT_BUILDCOMPILE,
null,
0,
fileName[0],
lineNumber[0],
taskItemText[0],
null);
}
else
{
buildPane.OutputString(buildMessage);
}
buildPane.OutputString("\n");
}