Freigeben über

Erstellen einer breiten Ansicht

In einer breiten Ansicht wird ein einzelner Wert für jedes angezeigte Objekt angezeigt. Der angezeigte Wert kann der Wert einer .NET-Objekteigenschaft oder der Wert eines Skripts sein. Standardmäßig gibt es keine Beschriftung oder Kopfzeile für diese Ansicht.

Breite Ansichtsanzeige

Das folgende Beispiel zeigt, wie Windows PowerShell das System.Diagnostics.Process--Objekt anzeigt, das vom Cmdlet Get-Process zurückgegeben wird, wenn die Ausgabe an das Cmdlet Format-Wide weitergeleitet wird. (Standardmäßig gibt das Cmdlet Get-Process eine Tabellenansicht zurück.) In diesem Beispiel werden die beiden Spalten verwendet, um den Namen des Prozesses für jedes zurückgegebene Objekt anzuzeigen. Der Name der Eigenschaft des Objekts wird nicht angezeigt, nur der Wert der Eigenschaft.

Get-Process | Format-Wide

AEADISRV                     agrsmsvc
Ati2evxx                     Ati2evxx
audiodg                      CCC
CcmExec                      communicator
Crypserv                     csrss
csrss                        DevDtct2
DM1Service                   dpupdchk
dwm                          DxStudio
EXCEL                        explorer
GoogleToolbarNotifier        GrooveMonitor
hpqwmiex                     hpservice
Idle                         InoRpc
InoRT                        InoTask
ipoint                       lsass
lsm                          MOM
MSASCui                      notepad
...                          ...

Definieren der breiten Ansicht

Der folgende XML-Code zeigt das Breitansichtsschema für das System.Diagnostics.Process-Objekt.

<View>
  <Name>process</Name>
  <ViewSelectedBy>
    <TypeName>System.Diagnostics.Process</TypeName>
  </ViewSelectedBy>
  <GroupBy>...</GroupBy>
  <Controls>...</Controls>
  <WideControl>
    <WideEntries>
      <WideEntry>
        <WideItem>
          <PropertyName>ProcessName</PropertyName>
        </WideItem>
      </WideEntry>
    </WideEntries>
  </WideControl>
</View>

Die folgenden XML-Elemente werden verwendet, um eine breite Ansicht zu definieren:

  • Das View-Element ist das übergeordnete Element der breiten Ansicht. (Dies ist dasselbe übergeordnete Element für die Tabellen-, Listen- und benutzerdefinierten Steuerelementansichten.)
  • Das Name--Element gibt den Namen der Ansicht an. Dieses Element ist für alle Ansichten erforderlich.
  • Das ViewSelectedBy-Element definiert die Objekte, die die Ansicht verwenden. Dieses Element ist erforderlich.
  • Das GroupBy-Element definiert, wann eine neue Gruppe von Objekten angezeigt wird. Eine neue Gruppe wird gestartet, wenn sich der Wert einer bestimmten Eigenschaft oder eines bestimmten Skripts ändert. Dieses Element ist optional.
  • Die Steuerelemente Elemente definieren die benutzerdefinierten Steuerelemente, die von der breiten Ansicht definiert werden. Mithilfe von Steuerelementen können Sie weiter angeben, wie die Daten angezeigt werden. Dieses Element ist optional. Eine Ansicht kann eigene benutzerdefinierte Steuerelemente definieren oder allgemeine Steuerelemente verwenden, die von jeder Ansicht in der Formatierungsdatei verwendet werden können. Weitere Informationen zu benutzerdefinierten Steuerelementen finden Sie unter Erstellen von benutzerdefinierten Steuerelementen.
  • Das WideControl-Element und seine untergeordneten Elemente definieren, was in der Ansicht angezeigt wird. Im vorherigen Beispiel wird die Ansicht so konzipiert, dass die System.Diagnostics.Process.ProcessName-Eigenschaft angezeigt wird.

Ein Beispiel für eine vollständige Formatierungsdatei, die eine einfache breite Ansicht definiert, finden Sie unter Wide View (Basic).

Bereitstellen von Definitionen für Ihre breite Ansicht

Breite Ansichten können eine oder mehrere Definitionen mithilfe der untergeordneten Elemente des WideControl--Elements bereitstellen. In der Regel verfügt eine Ansicht nur über eine Definition. Im folgenden Beispiel stellt die Ansicht eine einzelne Definition bereit, die die System.Diagnostics.Process.ProcessName-Eigenschaft anzeigt. Eine breite Ansicht kann den Wert einer Eigenschaft oder des Werts eines Skripts anzeigen (nicht im Beispiel dargestellt).

<WideControl>
  <AutoSize/>
  <ColumnNumber></ColumnNumber>
  <WideEntries>
    <WideEntry>
      <WideItem>
        <PropertyName>ProcessName</PropertyName>
      </WideItem>
    </WideEntry>
  </WideEntries>
</WideControl>

Die folgenden XML-Elemente können verwendet werden, um Definitionen für eine breite Ansicht bereitzustellen:

  • Das WideControl-Element und seine untergeordneten Elemente definieren, was in der Ansicht angezeigt wird.
  • Das AutoSize-Element gibt an, ob die Spaltengröße und die Anzahl der Spalten basierend auf der Größe der Daten angepasst werden. Dieses Element ist optional.
  • Das ColumnNumber-Element gibt die Anzahl der Spalten an, die in der breiten Ansicht angezeigt werden. Dieses Element ist optional.
  • Das WideEntries-Element stellt die Definitionen der Ansicht bereit. In den meisten Fällen verfügt eine Ansicht nur über eine Definition. Dieses Element ist erforderlich.
  • Das WideEntry--Element stellt eine Definition der Ansicht bereit. Mindestens ein WideEntry- ist erforderlich; Es gibt jedoch keinen Grenzwert für die Anzahl der Elemente, die Sie hinzufügen können. In den meisten Fällen verfügt eine Ansicht nur über eine Definition.
  • Das EntrySelectedBy-Element gibt die Objekte an, die von einer bestimmten Definition angezeigt werden. Dieses Element ist optional und wird nur benötigt, wenn Sie mehrere WideEntry- Elemente definieren, die unterschiedliche Objekte anzeigen.
  • Das WideItem--Element gibt die Daten an, die von der Ansicht angezeigt werden. Im Gegensatz zu anderen Arten von Ansichten kann ein breites Steuerelement nur ein Element anzeigen.
  • Das PropertyName-Element gibt die Eigenschaft an, deren Wert von der Ansicht angezeigt wird. Sie müssen entweder eine Eigenschaft oder ein Skript angeben, aber sie können nicht beide angeben.
  • Das ScriptBlock-Element gibt das Skript an, dessen Wert von der Ansicht angezeigt wird. Sie müssen entweder ein Skript oder eine Eigenschaft angeben, aber sie können nicht beide angeben.
  • Das FormatString--Element gibt ein Muster an, das zum Anzeigen der Daten verwendet wird. Dieses Element ist optional.

Ein Beispiel für eine vollständige Formatierungsdatei, die eine Breite Ansichtsdefinition definiert, finden Sie unter Wide View (Basic).

Definieren der Objekte, die die breite Ansicht verwenden

Es gibt zwei Möglichkeiten, zu definieren, welche .NET-Objekte die breite Ansicht verwenden. Sie können das ViewSelectedBy-Element verwenden, um die Objekte zu definieren, die von allen Definitionen der Ansicht angezeigt werden können, oder Sie können das EntrySelectedBy-Element verwenden, um zu definieren, welche Objekte durch eine bestimmte Definition der Ansicht angezeigt werden. In den meisten Fällen weist eine Ansicht nur eine Definition auf, sodass Objekte normalerweise vom ViewSelectedBy-Element definiert werden.

Das folgende Beispiel zeigt, wie Sie die Objekte definieren, die in der breiten Ansicht mithilfe der ViewSelectedBy- und TypeName--Elemente angezeigt werden. Es gibt keine Beschränkung auf die Anzahl der TypeName- Elemente, die Sie angeben können, und deren Reihenfolge ist nicht signifikant.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.Diagnostics.Process</TypeName>
  </ViewSelectedBy>
  <WideControl>...</WideControl>
</View>

Die folgenden XML-Elemente können verwendet werden, um die Objekte anzugeben, die von der breiten Ansicht verwendet werden:

  • Das ViewSelectedBy-Element definiert, welche Objekte von der breiten Ansicht angezeigt werden.
  • Das TypeName-Element gibt das .NET an, das von der Ansicht angezeigt wird. Der vollqualifizierte .NET-Typname ist erforderlich. Sie müssen mindestens einen Typ oder einen Auswahlsatz für die Ansicht angeben, es gibt jedoch keine maximale Anzahl von Elementen, die angegeben werden können.

Ein Beispiel für eine vollständige Formatierungsdatei finden Sie unter Wide View (Basic).

Im folgenden Beispiel werden die elemente ViewSelectedBy und SelectionSetName verwendet. Verwenden Sie Auswahlsätze, bei denen Sie über einen verwandten Satz von Objekten verfügen, die mit mehreren Ansichten angezeigt werden, z. B. wenn Sie eine breite Ansicht und eine Tabellenansicht für dieselben Objekte definieren. Weitere Informationen zum Erstellen eines Auswahlsatzes finden Sie unter Definieren von Auswahlsätzen.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <SelectionSetName>.NET Type Set</SelectionSetName>
  </ViewSelectedBy>
  <WideControl>...</WideControl>
</View>

Die folgenden XML-Elemente können verwendet werden, um die Objekte anzugeben, die von der breiten Ansicht verwendet werden:

  • Das ViewSelectedBy-Element definiert, welche Objekte von der breiten Ansicht angezeigt werden.
  • Das SelectionSetName-Element gibt einen Satz von Objekten an, die von der Ansicht angezeigt werden können. Sie müssen mindestens einen Auswahlsatz oder -typ für die Ansicht angeben, es gibt jedoch keine maximale Anzahl von Elementen, die angegeben werden können.

Im folgenden Beispiel wird gezeigt, wie die Objekte definiert werden, die mithilfe des EntrySelectedBy-Elements angezeigt werden. Mithilfe dieses Elements können Sie den .NET-Typnamen des Objekts, einen Auswahlsatz von Objekten oder eine Auswahlbedingung angeben, die angibt, wann die Definition verwendet wird. Weitere Informationen zum Erstellen einer Auswahlbedingungen finden Sie unter Definieren von Bedingungen zum Anzeigen von Daten.

<WideEntry>
  <EntrySelectedBy>
    <TypeName>.NET Type</TypeName>
  </EntrySelectedBy>
</WideEntry>

Die folgenden XML-Elemente können verwendet werden, um die Objekte anzugeben, die von einer bestimmten Definition der breiten Ansicht verwendet werden:

  • Das EntrySelectedBy-Element definiert, welche Objekte durch die Definition angezeigt werden.
  • Das TypeName-Element gibt das .NET an, das von der Definition angezeigt wird. Bei Verwendung dieses Elements ist der vollqualifizierte .NET-Typname erforderlich. Sie müssen mindestens einen Typ, einen Auswahlsatz oder eine Auswahlbedingung für die Definition angeben, es gibt jedoch keine maximale Anzahl von Elementen, die angegeben werden können.
  • Das SelectionSetName-Element (nicht dargestellt) gibt einen Satz von Objekten an, die von dieser Definition angezeigt werden können. Sie müssen mindestens einen Typ, einen Auswahlsatz oder eine Auswahlbedingung für die Definition angeben, es gibt jedoch keine maximale Anzahl von Elementen, die angegeben werden können.
  • Das SelectionCondition--Element (nicht dargestellt) gibt eine Bedingung an, die für diese Definition verwendet werden muss. Sie müssen mindestens einen Typ, einen Auswahlsatz oder eine Auswahlbedingung für die Definition angeben, es gibt jedoch keine maximale Anzahl von Elementen, die angegeben werden können. Weitere Informationen zum Definieren von Auswahlbedingungen finden Sie unter Definieren von Bedingungen zum Anzeigen von Daten.

Anzeigen von Gruppen von Objekten in einer breiten Ansicht

Sie können die Objekte, die von der breiten Ansicht angezeigt werden, in Gruppen trennen. Dies bedeutet nicht, dass Sie eine Gruppe definieren, nur dass Windows PowerShell eine neue Gruppe startet, wenn sich der Wert einer bestimmten Eigenschaft oder eines Bestimmten Skripts ändert. Im folgenden Beispiel wird eine neue Gruppe gestartet, wenn sich der Wert der System.ServiceProcess.ServiceController.ServiceType-Eigenschaft ändert.

<GroupBy>
  <Label>Service Type</Label>
  <PropertyName>ServiceType</PropertyName>
</GroupBy>

Die folgenden XML-Elemente werden verwendet, um zu definieren, wann eine Gruppe gestartet wird:

  • Das GroupBy-Element definiert die Eigenschaft oder das Skript, die die neue Gruppe startet, und definiert, wie die Gruppe angezeigt wird.
  • Das PropertyName-Element gibt die Eigenschaft an, die eine neue Gruppe startet, wenn sich der Wert ändert. Sie müssen eine Eigenschaft oder ein Skript angeben, um die Gruppe zu starten, aber Sie können nicht beide angeben.
  • Das ScriptBlock-Element gibt das Skript an, das eine neue Gruppe startet, wenn sich der Wert ändert. Sie müssen ein Skript oder eine Eigenschaft angeben, um die Gruppe zu starten, aber Sie können nicht beide angeben.
  • Das Label-Element definiert eine Bezeichnung, die am Anfang jeder Gruppe angezeigt wird. Neben dem durch dieses Element angegebenen Text zeigt Windows PowerShell den Wert an, der die neue Gruppe ausgelöst hat, und fügt vor und nach der Bezeichnung eine leere Zeile hinzu. Dieses Element ist optional.
  • Das CustomControl-Element definiert ein Steuerelement, das zum Anzeigen der Daten verwendet wird. Dieses Element ist optional.
  • Das CustomControlName-Element gibt ein allgemeines Steuerelement oder ein Ansichtssteuerelement an, das zum Anzeigen der Daten verwendet wird. Dieses Element ist optional.

Ein Beispiel für eine vollständige Formatierungsdatei, die Gruppen definiert, finden Sie unter Wide View (GroupBy).

Verwenden von Formatzeichenfolgen

Formatierungszeichenfolgen können einer breiten Ansicht hinzugefügt werden, um weiter zu definieren, wie die Daten angezeigt werden. Das folgende Beispiel zeigt, wie Sie eine Formatierungszeichenfolge für den Wert der eigenschaft StartTime definieren.

<WideItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} {0:DD} {0:HH}:{0:MM}</FormatString>
</WideItem>

Die folgenden XML-Elemente können verwendet werden, um ein Formatmuster anzugeben:

  • Das WideItem--Element gibt die Daten an, die von der Ansicht angezeigt werden.
  • Das PropertyName-Element gibt die Eigenschaft an, deren Wert von der Ansicht angezeigt wird. Sie müssen entweder eine Eigenschaft oder ein Skript angeben, aber sie können nicht beide angeben.
  • Das FormatString--Element gibt ein Formatmuster an, das definiert, wie die Eigenschaft oder der Skriptwert in der Ansicht angezeigt wird.
  • Das ScriptBlock-Element (nicht dargestellt) gibt das Skript an, dessen Wert von der Ansicht angezeigt wird. Sie müssen entweder ein Skript oder eine Eigenschaft angeben, aber sie können nicht beide angeben.

Im folgenden Beispiel wird die ToString-Methode aufgerufen, um den Wert des Skripts zu formatieren. Skripts können eine beliebige Methode eines Objekts aufrufen. Wenn ein Objekt über eine Methode wie ToStringverfügt, die Formatierungsparameter enthält, kann das Skript diese Methode aufrufen, um den Ausgabewert des Skripts zu formatieren.

<WideItem>
  <ScriptBlock>
    [string]::Format("{0,-10} {1,-8}", $_.LastWriteTime.ToString("d"), $_.LastWriteTime.ToString("t"))
  </ScriptBlock>
</WideItem>

Das folgende XML-Element kann zum Aufrufen der ToString-Methode verwendet werden:

  • Das WideItem--Element gibt die Daten an, die von der Ansicht angezeigt werden.
  • Das ScriptBlock-Element (nicht dargestellt) gibt das Skript an, dessen Wert von der Ansicht angezeigt wird. Sie müssen entweder ein Skript oder eine Eigenschaft angeben, aber sie können nicht beide angeben.

Siehe auch

  • Last updated on