Dela via

Skapa en bred vy

En bred vy visar ett enda värde för varje objekt som visas. Det visade värdet kan vara värdet för en .NET-objektegenskap eller värdet för ett skript. Som standard finns det ingen etikett eller rubrik för den här vyn.

En wide view-skärm

I följande exempel visas hur Windows PowerShell visar System.Diagnostics.Process objekt som returneras av cmdleten Get-Process när dess utdata skickas till cmdleten Format-Wide. (Som standard returnerar cmdleten Get-Process en tabellvy.) I det här exemplet används de två kolumnerna för att visa namnet på processen för varje returnerat objekt. Namnet på objektets egenskap visas inte, bara värdet för egenskapen.

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

Definiera den breda vyn

Följande XML visar wide view-schemat för objektet 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>

Följande XML-element används för att definiera en bred vy:

  • Elementet View är det överordnade elementet i den breda vyn. (Det här är samma överordnade element för tabell-, list- och anpassade kontrollvyer.)
  • Elementet Name anger namnet på vyn. Det här elementet krävs för alla vyer.
  • Elementet ViewSelectedBy definierar de objekt som använder vyn. Det här elementet krävs.
  • Elementet GroupBy definierar när en ny grupp med objekt visas. En ny grupp startas när värdet för en specifik egenskap eller ett visst skript ändras. Det här elementet är valfritt.
  • Elementen Controls definierar de anpassade kontroller som definieras av den breda vyn. Med kontroller kan du ange hur data ska visas ytterligare. Det här elementet är valfritt. En vy kan definiera sina egna anpassade kontroller eller använda vanliga kontroller som kan användas av valfri vy i formateringsfilen. Mer information om anpassade kontroller finns i Skapa anpassade kontroller.
  • Elementet WideControl och dess underordnade element definierar vad som visas i vyn. I föregående exempel är vyn utformad för att visa egenskapen System.Diagnostics.Process.ProcessName.

Ett exempel på en fullständig formateringsfil som definierar en enkel bred vy finns i Wide View (Basic).

Tillhandahålla definitioner för din breda vy

Breda vyer kan ge en eller flera definitioner med hjälp av underordnade element i elementet WideControl. Vanligtvis har en vy bara en definition. I följande exempel innehåller vyn en enda definition som visar egenskapen System.Diagnostics.Process.ProcessName. En bred vy kan visa värdet för en egenskap eller värdet för ett skript (visas inte i exemplet).

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

Följande XML-element kan användas för att tillhandahålla definitioner för en bred vy:

  • Elementet WideControl och dess underordnade element definierar vad som visas i vyn.
  • Elementet AutoSize anger om kolumnstorleken och antalet kolumner justeras baserat på datastorleken. Det här elementet är valfritt.
  • Elementet ColumnNumber anger antalet kolumner som visas i den breda vyn. Det här elementet är valfritt.
  • Elementet WideEntries innehåller definitionerna av vyn. I de flesta fall har en vy bara en definition. Det här elementet krävs.
  • Elementet WideEntry innehåller en definition av vyn. Minst en WideEntry- krävs. Det finns dock ingen maximal gräns för antalet element som du kan lägga till. I de flesta fall har en vy bara en definition.
  • Elementet EntrySelectedBy anger de objekt som visas med en specifik definition. Det här elementet är valfritt och behövs bara när du definierar flera WideEntry- element som visar olika objekt.
  • Elementet WideItem anger de data som visas av vyn. Till skillnad från andra typer av vyer kan en bred kontroll endast visa ett objekt.
  • Elementet PropertyName anger den egenskap vars värde visas av vyn. Du måste ange antingen en egenskap eller ett skript, men du kan inte ange båda.
  • Elementet ScriptBlock anger skriptet vars värde visas av vyn. Du måste ange antingen ett skript eller en egenskap, men du kan inte ange båda.
  • Elementet FormatString anger ett mönster som används för att visa data. Det här elementet är valfritt.

Ett exempel på en fullständig formateringsfil som definierar en bred vydefinition finns i Wide View (Basic).

Definiera de objekt som använder den breda vyn

Det finns två sätt att definiera vilka .NET-objekt som använder den breda vyn. Du kan använda elementet ViewSelectedBy för att definiera de objekt som kan visas av alla definitioner i vyn, eller så kan du använda elementet EntrySelectedBy för att definiera vilka objekt som visas med en specifik definition av vyn. I de flesta fall har en vy bara en definition, så objekt definieras vanligtvis av elementet ViewSelectedBy.

I följande exempel visas hur du definierar de objekt som visas i den breda vyn med hjälp av elementen ViewSelectedBy och TypeName. Det finns ingen gräns för antalet TypeName- element som du kan ange och deras ordning är inte betydande.

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

Följande XML-element kan användas för att ange de objekt som används av den breda vyn:

  • Elementet ViewSelectedBy definierar vilka objekt som visas i den breda vyn.
  • Elementet TypeName anger det .NET som visas av vyn. Det fullständigt kvalificerade .NET-typnamnet krävs. Du måste ange minst en typ eller markeringsuppsättning för vyn, men det finns inget maximalt antal element som kan anges.

Ett exempel på en fullständig formateringsfil finns i Wide View (Basic).

I följande exempel används elementen ViewSelectedBy och SelectionSetName. Använd markeringsuppsättningar där du har en relaterad uppsättning objekt som visas med flera vyer, till exempel när du definierar en bred vy och en tabellvy för samma objekt. Mer information om hur du skapar en markeringsuppsättning finns i Definiera markeringsuppsättningar.

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

Följande XML-element kan användas för att ange de objekt som används av den breda vyn:

  • Elementet ViewSelectedBy definierar vilka objekt som visas i den breda vyn.
  • Elementet SelectionSetName anger en uppsättning objekt som kan visas av vyn. Du måste ange minst en markeringsuppsättning eller typ för vyn, men det finns inget maximalt antal element som kan anges.

I följande exempel visas hur du definierar de objekt som visas med en specifik definition av den breda vyn med hjälp av elementet EntrySelectedBy. Med det här elementet kan du ange .NET-typnamnet för objektet, en markeringsuppsättning med objekt eller ett markeringsvillkor som anger när definitionen används. Mer information om hur du skapar ett urvalsvillkor finns i Definiera villkor för att visa data.

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

Följande XML-element kan användas för att ange de objekt som används av en specifik definition av den breda vyn:

  • Elementet EntrySelectedBy definierar vilka objekt som visas av definitionen.
  • Elementet TypeName anger det .NET som visas av definitionen. När du använder det här elementet krävs det fullständigt kvalificerade .NET-typnamnet. Du måste ange minst en typ, en markeringsuppsättning eller ett urvalsvillkor för definitionen, men det finns inget maximalt antal element som kan anges.
  • Elementet SelectionSetName (visas inte) anger en uppsättning objekt som kan visas med den här definitionen. Du måste ange minst en typ, en markeringsuppsättning eller ett urvalsvillkor för definitionen, men det finns inget maximalt antal element som kan anges.
  • Elementet SelectionCondition (visas inte) anger ett villkor som måste finnas för att den här definitionen ska kunna användas. Du måste ange minst en typ, en markeringsuppsättning eller ett urvalsvillkor för definitionen, men det finns inget maximalt antal element som kan anges. Mer information om hur du definierar urvalsvillkor finns i Definiera villkor för att visa data.

Visa grupper av objekt i en bred vy

Du kan separera de objekt som visas i den breda vyn i grupper. Det betyder inte att du definierar en grupp, bara att Windows PowerShell startar en ny grupp när värdet för en specifik egenskap eller ett visst skript ändras. I följande exempel startas en ny grupp när värdet för egenskapen System.ServiceProcess.ServiceController.ServiceType ändras.

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

Följande XML-element används för att definiera när en grupp startas:

  • Elementet GroupBy definierar egenskapen eller skriptet som startar den nya gruppen och definierar hur gruppen visas.
  • Elementet PropertyName anger den egenskap som startar en ny grupp när dess värde ändras. Du måste ange en egenskap eller ett skript för att starta gruppen, men du kan inte ange båda.
  • Elementet ScriptBlock anger skriptet som startar en ny grupp när dess värde ändras. Du måste ange ett skript eller en egenskap för att starta gruppen, men du kan inte ange båda.
  • Elementet Label definierar en etikett som visas i början av varje grupp. Förutom den text som anges av det här elementet visar Windows PowerShell värdet som utlöste den nya gruppen och lägger till en tom rad före och efter etiketten. Det här elementet är valfritt.
  • Elementet CustomControl definierar en kontroll som används för att visa data. Det här elementet är valfritt.
  • Elementet CustomControlName anger en gemensam kontroll eller vykontroll som används för att visa data. Det här elementet är valfritt.

Ett exempel på en fullständig formateringsfil som definierar grupper finns i Wide View (GroupBy).

Använda formatsträngar

Formateringssträngar kan läggas till i en bred vy för att ytterligare definiera hur data ska visas. I följande exempel visas hur du definierar en formateringssträng för värdet för egenskapen StartTime.

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

Följande XML-element kan användas för att ange ett formatmönster:

  • Elementet WideItem anger de data som visas av vyn.
  • Elementet PropertyName anger den egenskap vars värde visas av vyn. Du måste ange antingen en egenskap eller ett skript, men du kan inte ange båda.
  • Elementet FormatString anger ett formatmönster som definierar hur egenskapen eller skriptvärdet visas i vyn
  • Elementet ScriptBlock (visas inte) anger det skript vars värde visas av vyn. Du måste ange antingen ett skript eller en egenskap, men du kan inte ange båda.

I följande exempel anropas metoden ToString för att formatera värdet för skriptet. Skript kan anropa vilken metod som helst för ett objekt. Om ett objekt har en metod, till exempel ToString, som har formateringsparametrar, kan skriptet anropa den metoden för att formatera utdatavärdet för skriptet.

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

Följande XML-element kan användas för att anropa metoden ToString:

  • Elementet WideItem anger de data som visas av vyn.
  • Elementet ScriptBlock (visas inte) anger det skript vars värde visas av vyn. Du måste ange antingen ett skript eller en egenskap, men du kan inte ange båda.

Se även