Een brede weergave maken

2025-03-25

In een brede weergave wordt één waarde weergegeven voor elk object dat wordt weergegeven. De weergegeven waarde kan de waarde zijn van een .NET-objecteigenschap of de waarde van een script. Standaard is er geen label of koptekst voor deze weergave.

Een breedbeeldscherm

In het volgende voorbeeld ziet u hoe Windows PowerShell het System.Diagnostics.Process-object weergeeft dat wordt geretourneerd door de cmdlet Get-Process wanneer de uitvoer wordt doorgesluisd naar de cmdlet Format-Wide. (De cmdlet Get-Process retourneert standaard een tabelweergave.) In dit voorbeeld worden de twee kolommen gebruikt om de naam van het proces voor elk geretourneerd object weer te geven. De naam van de eigenschap van het object wordt niet weergegeven, alleen de waarde van de eigenschap.

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
...                          ...

De brede weergave definiëren

In de volgende XML ziet u het brede weergaveschema voor het object System.Diagnostics.Process.

<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>

De volgende XML-elementen worden gebruikt om een brede weergave te definiëren:

Het element Weergave is het bovenliggende element van de brede weergave. (Dit is hetzelfde bovenliggende element voor de tabel-, lijst- en aangepaste besturingsweergaven.)
Het element Name geeft de naam van de weergave op. Dit element is vereist voor alle weergaven.
Het element ViewSelectedBy definieert de objecten die de weergave gebruiken. Dit element is vereist.
Het element GroupBy definieert wanneer een nieuwe groep objecten wordt weergegeven. Er wordt een nieuwe groep gestart wanneer de waarde van een specifieke eigenschap of script wordt gewijzigd. Dit element is optioneel.
De Besturingselementen elementen definieert de aangepaste besturingselementen die door de brede weergave worden gedefinieerd. Met besturingselementen kunt u verder opgeven hoe de gegevens worden weergegeven. Dit element is optioneel. Een weergave kan eigen aangepaste besturingselementen definiëren, maar ook algemene besturingselementen gebruiken die door elke weergave in het opmaakbestand kunnen worden gebruikt. Zie Aangepaste besturingselementen makenvoor meer informatie over aangepaste besturingselementen.
Het element WideControl en de onderliggende elementen bepalen wat er in de weergave wordt weergegeven. In het voorgaande voorbeeld is de weergave ontworpen om de eigenschap System.Diagnostics.Process.ProcessName weer te geven.

Zie Wide View (Basic)voor een voorbeeld van een volledig opmaakbestand dat een eenvoudige brede weergave definieert.

Definities instellen voor uw brede weergave

Brede weergaven kunnen een of meer definities bieden met behulp van de onderliggende elementen van het WideControl-element. Normaal gesproken heeft een weergave slechts één definitie. In het volgende voorbeeld bevat de weergave één definitie waarin de eigenschap System.Diagnostics.Process.Process.ProcessName wordt weergegeven. Een brede weergave kan de waarde van een eigenschap of de waarde van een script weergeven (niet weergegeven in het voorbeeld).

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

De volgende XML-elementen kunnen worden gebruikt om definities te bieden voor een brede weergave:

Het element WideControl en de onderliggende elementen bepalen wat er in de weergave wordt weergegeven.
De element autoSize specificeert of de kolomgrootte en het aantal kolommen worden aangepast op basis van de grootte van de gegevens. Dit element is optioneel.
Het element ColumnNumber geeft het aantal kolommen op dat in de brede weergave wordt weergegeven. Dit element is optioneel.
Het element WideEntries bevat de definities van de weergave. In de meeste gevallen heeft een weergave slechts één definitie. Dit element is vereist.
Het element WideEntry biedt een definitie van de weergave. Ten minste één WideEntry- is vereist; er is echter geen maximumlimiet voor het aantal elementen dat u kunt toevoegen. In de meeste gevallen heeft een weergave slechts één definitie.
Het element EntrySelectedBy geeft de objecten op die door een specifieke definitie worden weergegeven. Dit element is optioneel en is alleen nodig wanneer u meerdere WideEntry elementen definieert die verschillende objecten weergeven.
Het element WideItem geeft de gegevens op die door de weergave worden weergegeven. In tegenstelling tot andere typen weergaven kan een breed besturingselement slechts één item weergeven.
Het element PropertyName geeft de eigenschap op waarvan de waarde wordt weergegeven door de weergave. U moet een eigenschap of een script opgeven, maar u kunt beide niet opgeven.
Het element ScriptBlock geeft het script op waarvan de waarde door de weergave wordt weergegeven. U moet een script of een eigenschap opgeven, maar u kunt beide niet opgeven.
Het element FormatString geeft een patroon op dat wordt gebruikt om de gegevens weer te geven. Dit element is optioneel.

Zie Wide View (Basic)voor een voorbeeld van een volledig opmaakbestand dat een brede weergavedefinitie definieert.

De objecten definiëren die gebruikmaken van de brede weergave

Er zijn twee manieren om te definiëren welke .NET-objecten gebruikmaken van de brede weergave. U kunt het element ViewSelectedBy gebruiken om de objecten te definiëren die door alle definities van de weergave kunnen worden weergegeven, of u kunt het element EntrySelectedBy gebruiken om te definiëren welke objecten worden weergegeven door een specifieke definitie van de weergave. In de meeste gevallen heeft een weergave slechts één definitie, dus objecten worden doorgaans gedefinieerd door het element ViewSelectedBy.

In het volgende voorbeeld ziet u hoe u de objecten definieert die in de brede weergave worden weergegeven met behulp van de elementen ViewSelectedBy en TypeName. Er is geen limiet voor het aantal TypeName elementen die u kunt opgeven en de volgorde ervan is niet significant.

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

De volgende XML-elementen kunnen worden gebruikt om de objecten op te geven die door de brede weergave worden gebruikt:

Het element ViewSelectedBy bepaalt welke objecten worden weergegeven door de brede weergave.
Het element TypeName geeft het .NET op dat door de weergave wordt weergegeven. De volledig gekwalificeerde .NET-typenaam is vereist. U moet ten minste één type of selectie opgeven dat is ingesteld voor de weergave, maar er is geen maximum aantal elementen dat kan worden opgegeven.

Zie Wide View (Basic)voor een voorbeeld van een volledig opmaakbestand.

In het volgende voorbeeld worden de elementen ViewSelectedBy en SelectionSetName gebruikt. Gebruik selectiesets waarin u een gerelateerde set objecten hebt die worden weergegeven met meerdere weergaven, zoals wanneer u een brede weergave en een tabelweergave definieert voor dezelfde objecten. Zie Selectiesets definiërenvoor meer informatie over het maken van een selectieset.

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

De volgende XML-elementen kunnen worden gebruikt om de objecten op te geven die door de brede weergave worden gebruikt:

Het element ViewSelectedBy bepaalt welke objecten worden weergegeven door de brede weergave.
Het element SelectionSetName geeft een set objecten op die door de weergave kunnen worden weergegeven. U moet ten minste één selectieset of type opgeven voor de weergave, maar er is geen maximum aantal elementen dat kan worden opgegeven.

In het volgende voorbeeld ziet u hoe u de objecten definieert die worden weergegeven door een specifieke definitie van de brede weergave met behulp van het element EntrySelectedBy. Met dit element kunt u de .NET-typenaam van het object, een selectieset objecten of een selectievoorwaarde opgeven die aangeeft wanneer de definitie wordt gebruikt. Zie Voorwaarden definiëren voor het weergeven van gegevensvoor meer informatie over het maken van een selectievoorwaarden.

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

De volgende XML-elementen kunnen worden gebruikt om de objecten op te geven die worden gebruikt door een specifieke definitie van de brede weergave:

Het element EntrySelectedBy bepaalt welke objecten door de definitie worden weergegeven.
Het element TypeName geeft het .NET op dat door de definitie wordt weergegeven. Wanneer u dit element gebruikt, is de volledig gekwalificeerde .NET-typenaam vereist. U moet ten minste één type, selectieset of selectievoorwaarde voor de definitie opgeven, maar er is geen maximum aantal elementen dat kan worden opgegeven.
De SelectionSetName element (niet weergegeven) geeft een set objecten op die door deze definitie kunnen worden weergegeven. U moet ten minste één type, selectieset of selectievoorwaarde voor de definitie opgeven, maar er is geen maximum aantal elementen dat kan worden opgegeven.
Het element SelectionCondition (niet weergegeven) geeft een voorwaarde op die moet bestaan voor deze definitie die moet worden gebruikt. U moet ten minste één type, selectieset of selectievoorwaarde voor de definitie opgeven, maar er is geen maximum aantal elementen dat kan worden opgegeven. Zie Voorwaarden definiëren voor het weergeven van gegevensvoor meer informatie over het definiëren van selectievoorwaarden.

Groepen objecten weergeven in een brede weergave

U kunt de objecten scheiden die door de brede weergave in groepen worden weergegeven. Dit betekent niet dat u een groep definieert, alleen dat Windows PowerShell een nieuwe groep start wanneer de waarde van een specifieke eigenschap of script wordt gewijzigd. In het volgende voorbeeld wordt een nieuwe groep gestart wanneer de waarde van de eigenschap System.ServiceProcess.ServiceController.ServiceType wordt gewijzigd.

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

De volgende XML-elementen worden gebruikt om te definiëren wanneer een groep wordt gestart:

Het element GroupBy definieert de eigenschap of het script waarmee de nieuwe groep wordt gestart en definieert hoe de groep wordt weergegeven.
Het element PropertyName geeft de eigenschap op die een nieuwe groep start wanneer de waarde wordt gewijzigd. U moet een eigenschap of script opgeven om de groep te starten, maar u kunt niet beide opgeven.
Het element ScriptBlock geeft het script op dat een nieuwe groep start wanneer de waarde wordt gewijzigd. U moet een script of eigenschap opgeven om de groep te starten, maar u kunt niet beide opgeven.
Het element Label definieert een label dat aan het begin van elke groep wordt weergegeven. Naast de tekst die door dit element is opgegeven, geeft Windows PowerShell de waarde weer die de nieuwe groep heeft geactiveerd en voegt een lege regel toe vóór en na het label. Dit element is optioneel.
Het element CustomControl definieert een besturingselement dat wordt gebruikt om de gegevens weer te geven. Dit element is optioneel.
Het element CustomControlName geeft een algemeen besturingselement of weergavebeheer op dat wordt gebruikt om de gegevens weer te geven. Dit element is optioneel.

Zie Wide View (GroupBy)voor een voorbeeld van een volledig opmaakbestand dat groepen definieert.

Tekenreeksen opmaken

Opmaaktekenreeksen kunnen worden toegevoegd aan een brede weergave om verder te definiëren hoe de gegevens worden weergegeven. In het volgende voorbeeld ziet u hoe u een opmaaktekenreeks definieert voor de waarde van de eigenschap StartTime.

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

De volgende XML-elementen kunnen worden gebruikt om een opmaakpatroon op te geven:

Het element WideItem geeft de gegevens op die door de weergave worden weergegeven.
Het element PropertyName geeft de eigenschap op waarvan de waarde wordt weergegeven door de weergave. U moet een eigenschap of een script opgeven, maar u kunt beide niet opgeven.
Het element FormatString geeft een notatiepatroon op waarmee wordt gedefinieerd hoe de eigenschap of scriptwaarde wordt weergegeven in de weergave
Het ScriptBlock element (niet weergegeven) geeft het script op waarvan de waarde wordt weergegeven door de weergave. U moet een script of een eigenschap opgeven, maar u kunt beide niet opgeven.

In het volgende voorbeeld wordt de methode ToString aangeroepen om de waarde van het script op te maken. Scripts kunnen elke methode van een object aanroepen. Als een object dus een methode heeft, zoals ToString, met opmaakparameters, kan het script die methode aanroepen om de uitvoerwaarde van het script op te maken.

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

Het volgende XML-element kan worden gebruikt om de methode ToString aan te roepen:

Het element WideItem geeft de gegevens op die door de weergave worden weergegeven.
Het ScriptBlock element (niet weergegeven) geeft het script op waarvan de waarde wordt weergegeven door de weergave. U moet een script of een eigenschap opgeven, maar u kunt beide niet opgeven.

Zie ook

Feedback

Is deze pagina nuttig?