Listanézet létrehozásaCreating a List View

A listanézet egyetlen oszlopban jeleníti meg az adatait (szekvenciális sorrendben).A list view displays data in a single column (in sequential order). A listában megjelenített adatmennyiség lehet egy .NET-tulajdonság értéke vagy egy parancsfájl értéke.The data displayed in the list can be the value of a .NET property or the value of a script.

Listanézet megjelenítéseA List View Display

A következő kimenet bemutatja, hogyan jeleníti meg a Windows PowerShell a System. Serviceprocess. ServiceController tulajdonságait? Displayproperty = a Get-Service parancsmag által visszaadott FullName objektumok.The following output shows how Windows PowerShell displays the properties of System.Serviceprocess.Servicecontroller?Displayproperty=Fullname objects that are returned by the Get-Service cmdlet. Ebben a példában három objektumot adott vissza, és minden objektum üres vonallal van elválasztva az előző objektumtól.In this example, three objects were returned, with each object separated from the preceding object by a blank line.

Get-Service | format-list
Name                : AEADIFilters
DisplayName         : Andrea ADI Filters Service
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32OwnProcess

Name                : AeLookupSvc
DisplayName         : Application Experience
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32ShareProcess

Name                : AgereModemAudio
DisplayName         : Agere Modem Call Progress Audio
Status              : Running
DependentServices   : {}
ServicesDependedOn  : {}
CanPauseAndContinue : False
CanShutdown         : False
CanStop             : True
ServiceType         : Win32OwnProcess
...

A listanézet meghatározásaDefining the List View

A következő XML a listanézet sémáját mutatja be a System. Serviceprocess. ServiceController számos tulajdonságának megjelenítéséhez? Displayproperty = FullName objektum.The following XML shows the list view schema for displaying several properties of the System.Serviceprocess.Servicecontroller?Displayproperty=Fullname object. Meg kell adnia minden olyan tulajdonságot, amelyet meg szeretne jeleníteni a listanézetban.You must specify each property that you want displayed in the list view.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>
</View>

A következő XML-elemek a listanézet definiálására használhatók:The following XML elements are used to define a list view:

  • A View elem a listanézet szülő eleme.The View element is the parent element of the list view. (Ez ugyanaz a szülő elem a tábla, a széles és az egyéni vezérlő nézetek esetében.)(This is the same parent element for the table, wide, and custom control views.)

  • A név elem a nézet nevét adja meg.The Name element specifies the name of the view. Ez az elem minden nézet esetében kötelező.This element is required for all views.

  • A ViewSelectedBy elem a nézetet használó objektumokat határozza meg.The ViewSelectedBy element defines the objects that use the view. Ezt az elemet kötelező megadni.This element is required.

  • A GroupBy elem határozza meg, hogy mikor jelenjen meg egy új objektum.The GroupBy element defines when a new group of objects is displayed. Egy új csoport indul el, amikor egy adott tulajdonság vagy parancsfájl módosul.A new group is started whenever the value of a specific property or script changes. Ez az elem nem kötelező.This element is optional.

  • A vezérlők elem a listanézet által meghatározott egyéni vezérlőket határozza meg.The Controls element defines the custom controls that are defined by the list view. A vezérlők lehetővé teszik az adatmegjelenítés további megadását.Controls give you a way to further specify how the data is displayed. Ez az elem nem kötelező.This element is optional. A nézetek meghatározhatják saját egyéni vezérlőit, vagy használhatnak olyan közös vezérlőket is, amelyeket a formázó fájlban bármely nézet használhat.A view can define its own custom controls, or it can use common controls that can be used by any view in the formatting file. Az egyéni vezérlőkkel kapcsolatos további információkért lásd: Egyéni vezérlők létrehozása.For more information about custom controls, see Creating Custom Controls.

  • A ListControl elem határozza meg, hogy mi jelenjen meg a nézetben, és hogyan történik a formázása.The ListControl element defines what is displayed in the view and how it is formatted. Az összes többi nézethez hasonlóan a listanézet is megjelenítheti a parancsfájl által generált objektumok tulajdonságainak vagy értékeinek értékeit.Similar to all other views, a list view can display the values of object properties or values generated by script.

A listanézet (alapszintű)nézetből megtudhatja, hogyan határozhat meg egy egyszerű listanézet-nézetet tartalmazó teljes formázási fájlt.For an example of a complete formatting file that defines a simple list view, see List View (Basic).

A lista nézet definícióinak megadásaProviding Definitions for Your List View

A listanézet egy vagy több definíciót is biztosíthat a ListControl elem alárendelt elemeinek használatával.List views can provide one or more definitions by using the child elements of the ListControl element. A nézet általában csak egy definícióval fog rendelkezni.Typically, a view will have only one definition. A következő példában a nézet egyetlen definíciót tartalmaz, amely megjeleníti a System. Diagnostics. Process számos tulajdonságát? Displayproperty = FullName objektum.In the following example, the view provides a single definition that displays several properties of the System.Diagnostics.Process?Displayproperty=Fullname object. A listanézet megjelenítheti egy tulajdonság értékét vagy egy parancsfájl értékét (a példában nem látható).A list view can display the value of a property or the value of a script (not shown in the example).

<ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>

A következő XML-elemek használhatók a listanézet definícióinak megadásához:The following XML elements can be used to provide definitions for a list view:

  • A ListControl elem és a hozzá tartozó alárendelt elemek határozzák meg, hogy mi jelenjen meg a nézetben.The ListControl element and its child elements define what is displayed in the view.

  • A ListEntries elem a nézet definícióit tartalmazza.The ListEntries element provides the definitions of the view. A legtöbb esetben egy nézetnek csak egy definíciója lesz.In most cases, a view will have only one definition. Ezt az elemet kötelező megadni.This element is required.

  • A ListEntry elem a nézet definícióját tartalmazza.The ListEntry element provides a definition of the view. Legalább egy ListEntry megadása kötelező; a felvehető elemek száma azonban nem lehet felső korlát.At least one ListEntry is required; however, there is no maximum limit to the number of elements that you can add. A legtöbb esetben egy nézetnek csak egy definíciója lesz.In most cases, a view will have only one definition.

  • A EntrySelectedBy elem az adott definíció által megjelenített objektumokat határozza meg.The EntrySelectedBy element specifies the objects that are displayed by a specific definition. Ez az elem nem kötelező, és csak akkor szükséges, ha több ListEntry elemet ad meg, amelyek különböző objektumokat jelenítenek meg.This element is optional and is needed only when you define multiple ListEntry elements that display different objects.

  • A ListItems elem azokat a tulajdonságokat és parancsfájlokat adja meg, amelyek értékei megjelennek a listanézet soraiban.The ListItems element specifies the properties and scripts whose values are displayed in the rows of the list view.

  • A listaelem elem olyan tulajdonságot vagy parancsfájlt határoz meg, amelynek értéke a listanézet egy sorában jelenik meg.The ListItem element specifies a property or script whose value is displayed in a row of the list view. A listanézetnak legalább egy tulajdonságot vagy parancsfájlt kell megadnia.A list view must specify at least one property or script. A megadható sorok száma nincs korlátozva.There is no maximum limit to the number of rows that can be specified.

  • A PropertyName elem meghatározza azt a tulajdonságot, amelynek értéke megjelenik a sorban.The PropertyName element specifies the property whose value is displayed in the row. Meg kell adnia egy tulajdonságot vagy egy parancsfájlt, de mindkettőt nem adhatja meg.You must specify either a property or a script, but you cannot specify both.

  • A scriptblock kulcsszót elem meghatározza azt a parancsfájlt, amelynek értéke megjelenik a sorban.The ScriptBlock element specifies the script whose value is displayed in the row. Meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem adhatja meg.You must specify either a script or a property, but you cannot specify both.

  • A label elem a sorban lévő tulajdonság vagy parancsfájl értékének bal oldalán megjelenő címkét adja meg.The Label element specifies the label that is displayed to the left of the property or script value in the row. Ez az elem nem kötelező.This element is optional. Ha nincs megadva címke, a tulajdonság vagy a parancsfájl neve jelenik meg.If a label is not specified, the name of the property or the script is displayed. Teljes példaként tekintse meg a listanézet (címkék)című témakört.For a complete example, see List View (Labels).

  • A ItemSelectionCondition elem olyan feltételt határoz meg, amely léteznie kell a sor megjelenítéséhez.The ItemSelectionCondition element specifies a condition that must exist for the row to be displayed. A feltételeknek a listanézethoz való hozzáadásával kapcsolatos további információkért lásd: az adatok megjelenítésére vonatkozó feltételek meghatározása.For more information about adding conditions to the list view, see Defining Conditions for Displaying Data. Ez az elem nem kötelező.This element is optional.

  • A FormatString elem meghatározza a tulajdonság vagy a parancsfájl értékének megjelenítésére szolgáló mintát.The FormatString element specifies a pattern that is used to display the value of the property or script. Ez az elem nem kötelező.This element is optional.

A listanézet (alapszintű)nézetből megtudhatja, hogyan határozhat meg egy egyszerű listanézet-nézetet tartalmazó teljes formázási fájlt.For an example of a complete formatting file that defines a simple list view, see List View (Basic).

A listanézet-t használó objektumok meghatározásaDefining the Objects That Use the List View

Két módon határozható meg, hogy mely .NET-objektumok használják a listanézet-t.There are two ways to define which .NET objects use the list view. A ViewSelectedBy elemmel definiálhatja azokat az objektumokat, amelyeket a nézet összes definíciója megjelenít, vagy a EntrySelectedBy elem használatával meghatározhatja, hogy mely objektumok jelenjenek meg a nézet adott definíciójában.You can use the ViewSelectedBy element to define the objects that can be displayed by all the definitions of the view, or you can use the EntrySelectedBy element to define which objects are displayed by a specific definition of the view. A legtöbb esetben a nézetnek csak egy definíciója van, így az objektumokat általában a ViewSelectedBy elem határozza meg.In most cases, a view has only one definition, so objects are typically defined by the ViewSelectedBy element.

Az alábbi példa bemutatja, hogyan határozhatja meg a listanézet által megjelenített objektumokat a ViewSelectedBy és a TypeName elemek használatával.The following example shows how to define the objects that are displayed by the list view using the ViewSelectedBy and TypeName elements. A megadható TypeName elemek száma nincs korlátozva, és a sorrendjük nem jelentős.There is no limit to the number of TypeName elements that you can specify, and their order is not significant.

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

A következő XML-elemek használatával adhatja meg a listanézet által használt objektumokat:The following XML elements can be used to specify the objects that are used by the list view:

  • A ViewSelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a listanézet alapján.The ViewSelectedBy element defines which objects are displayed by the list view.

  • A TypeName elem a nézet által megjelenített .net-objektumot határozza meg.The TypeName element specifies the .NET object that is displayed by the view. A teljes .NET-típus nevének megadása kötelező.The fully qualified .NET type name is required. Meg kell adnia legalább egy típust vagy kiválasztási készletet a nézethez, de nem adhat meg maximális számú elemet.You must specify at least one type or selection set for the view, but there is no maximum number of elements that can be specified.

A teljes formázási fájlra vonatkozó példát a listanézet (alapszintű)című témakörben tekintheti meg.For an example of a complete formatting file, see List View (Basic).

A következő példa a ViewSelectedBy és a SelectionSetName elemeket használja.The following example uses the ViewSelectedBy and SelectionSetName elements. Olyan kiválasztási készleteket használjon, amelyekben több nézet használatával megjelenő objektumok is megjelennek, például ha egy listanézet és egy tábla nézet is meg van határozva ugyanahhoz az objektumhoz.Use selection sets where you have a related set of objects that are displayed using multiple views, such as when you define a list view and a table view for the same objects. A kiválasztási csoportok létrehozásával kapcsolatos további információkért lásd: kiválasztási készletek meghatározása.For more information about how to create a selection set, see Defining Selection Sets.

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

A következő XML-elemek használatával adhatja meg a listanézet által használt objektumokat:The following XML elements can be used to specify the objects that are used by the list view:

  • A ViewSelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a listanézet alapján.The ViewSelectedBy element defines which objects are displayed by the list view.

  • A SelectionSetName elem a nézet által megjeleníthető objektumok halmazát határozza meg.The SelectionSetName element specifies a set of objects that can be displayed by the view. Meg kell adnia legalább egy kiválasztási készletet vagy típust a nézethez, de nem adhat meg maximális számú elemet.You must specify at least one selection set or type for the view, but there is no maximum number of elements that can be specified.

Az alábbi példa bemutatja, hogyan határozhatja meg a listanézet adott definíciójában megjelenített objektumokat a EntrySelectedBy elem használatával.The following example shows how to define the objects displayed by a specific definition of the list view using the EntrySelectedBy element. Ennek az elemnek a használatával megadhatja az objektum .NET-típusának nevét, az objektumok kiválasztási halmazát, vagy egy olyan kiválasztási feltételt, amely megadja, hogy a rendszer mikor használja a definíciót.Using this element, you can specify the .NET type name of the object, a selection set of objects, or a selection condition that specifies when the definition is used. A kiválasztási feltételek létrehozásával kapcsolatos további információkért lásd: az adatok megjelenítésére vonatkozó feltételek meghatározása.For more information about how to create a selection conditions, see Defining Conditions for Displaying Data.

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

A következő XML-elemek használhatók a listanézet adott definíciója által használt objektumok megadására:The following XML elements can be used to specify the objects that are used by a specific definition of the list view:

  • A EntrySelectedBy elem határozza meg, hogy mely objektumok jelenjenek meg a definícióban.The EntrySelectedBy element defines which objects are displayed by the definition.

  • A TypeName elem a definícióban megjelenő .net-objektumot határozza meg.The TypeName element specifies the .NET object that is displayed by the definition. Ezen elem használatakor a teljes .NET-típus nevét kötelező megadni.When using this element, the fully qualified .NET type name is required. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified.

  • A SelectionSetName elem (nem látható) olyan objektumok készletét határozza meg, amelyeket ez a definíció megjelenít.The SelectionSetName element (not shown) specifies a set of objects that can be displayed by this definition. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified.

  • A SelectionCondition elem (nem látható) egy olyan feltételt határoz meg, amelynek léteznie kell ehhez a definícióhoz.The SelectionCondition element (not shown) specifies a condition that must exist for this definition to be used. Meg kell adnia legalább egy típust, kiválasztási készletet vagy kiválasztási feltételt a definícióhoz, de nem adhat meg maximális számú elemet.You must specify at least one type, selection set, or selection condition for the definition, but there is no maximum number of elements that can be specified. A kiválasztási feltételek definiálásával kapcsolatos további információkért lásd: az adatok megjelenítésére vonatkozó feltételek meghatározása.For more information about defining selection conditions, see Defining Conditions for Displaying Data.

Objektumok csoportjai megjelenítése a lista nézetbenDisplaying Groups of Objects in a List View

A listanézet által megjelenített objektumokat csoportokba különítheti el.You can separate the objects that are displayed by the list view into groups. Ez nem jelenti azt, hogy definiál egy csoportot, csak azt, hogy a Windows PowerShell új csoportot indít el, amikor egy adott tulajdonság vagy parancsfájl értéke megváltozik.This does not mean that you define a group, only that Windows PowerShell starts a new group whenever the value of a specific property or script changes. A következő példában egy új csoport indul el, amikor megváltoznak a System. Serviceprocess. ServiceController. ServiceType tulajdonság értéke.In the following example, a new group is started whenever the value of the System.Serviceprocess.Servicecontroller.Servicetype property changes.

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

A csoportok indításakor a következő XML-elemek használhatók:The following XML elements are used to define when a group is started:

  • A GroupBy elem határozza meg azt a tulajdonságot vagy parancsfájlt, amely elindítja az új csoportot, és meghatározza a csoport megjelenését.The GroupBy element defines the property or script that starts the new group and defines how the group is displayed.

  • A PropertyName elem azt a tulajdonságot határozza meg, amely új csoportot indít el, amikor az értéke megváltozik.The PropertyName element specifies the property that starts a new group whenever its value changes. Meg kell adnia egy tulajdonságot vagy parancsfájlt a csoport elindításához, de mindkettőt nem lehet megadnia.You must specify a property or script to start the group, but you cannot specify both.

  • A scriptblock kulcsszót elem határozza meg azt a parancsfájlt, amely egy új csoportot indít el, amikor az értéke megváltozik.The ScriptBlock element specifies the script that starts a new group whenever its value changes. A csoport elindításához meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem lehet megadnia.You must specify a script or property to start the group, but you cannot specify both.

  • A label elem az egyes csoportok elején megjelenő címkét határozza meg.The Label element defines a label that is displayed at the beginning of each group. Az elem által megadott szöveg mellett a Windows PowerShell megjeleníti az új csoportot kiváltó értéket, és egy üres sort ad hozzá a címke előtt és után.In addition to the text specified by this element, Windows PowerShell displays the value that triggered the new group and adds a blank line before and after the label. Ez az elem nem kötelező.This element is optional.

  • A CustomControl elem az adatmegjelenítéshez használt vezérlőelemet határozza meg.The CustomControl element defines a control that is used to display the data. Ez az elem nem kötelező.This element is optional.

  • A CustomControlName elem az adatmegjelenítéshez használt általános vagy nézet vezérlőelemet határozza meg.The CustomControlName element specifies a common or view control that is used to display the data. Ez az elem nem kötelező.This element is optional.

A csoportokat meghatározó teljes formázási fájlra példát a listanézet (GroupBy)című témakörben talál.For an example of a complete formatting file that defines groups, see List View (GroupBy).

Formázó sztringek használataUsing Format Strings

A formázási karakterláncok hozzáadhatók egy nézethez, hogy tovább lehessen meghatározni az adatmegjelenítés módját.Formatting strings can be added to a view to further define how the data is displayed. Az alábbi példa bemutatja, hogyan határozhat meg formázó karakterláncot a tulajdonság értékéhez StartTime .The following example shows how to define a formatting string for the value of the StartTime property.

<ListItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} (0:DD) (0:HH):(0:MM)</FormatString>
</ListItem>

A következő XML-elemek használhatók a formátum mintázatának megadásához:The following XML elements can be used to specify a format pattern:

  • A listaelem elem a nézet által megjelenített adatértékeket határozza meg.The ListItem element specifies the data that is displayed by the view.

  • A PropertyName elem határozza meg azt a tulajdonságot, amelynek az értékét a nézet jeleníti meg.The PropertyName element specifies the property whose value is displayed by the view. Meg kell adnia egy tulajdonságot vagy egy parancsfájlt, de mindkettőt nem adhatja meg.You must specify either a property or a script, but you cannot specify both.

  • A FormatString elem olyan formázási mintát határoz meg, amely meghatározza, hogyan jelenjen meg a tulajdonság vagy a parancsfájl értéke a nézetben.The FormatString element specifies a format pattern that defines how the property or script value is displayed in the view.

  • A scriptblock kulcsszót elem (nem látható) Megadja azt a parancsfájlt, amelynek az értékét a nézet jeleníti meg.The ScriptBlock element (not shown) specifies the script whose value is displayed by the view. Meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem adhatja meg.You must specify either a script or a property, but you cannot specify both.

A következő példában a ToString metódust a rendszer a parancsfájl értékének formázására hívja meg.In the following example, the ToString method is called to format the value of the script. A parancsfájlok bármely objektum metódusát hívhatják.Scripts can call any method of an object. Ezért ha egy objektumnak van olyan metódusa (például ToString ), amely formázó paramétereket tartalmaz, a parancsfájl meghívhatja ezt a metódust a parancsfájl kimeneti értékének formázására.Therefore, if an object has a method, such as ToString, that has formatting parameters, the script can call that method to format the output value of the script.

<ListItem>
  <ScriptBlock>
    [String}::Format("(0,10) (1,8)", .LastWriteTime.ToString("d"),
    $_.LastWriteTime.Totring("t"))
  </ScriptBlock>
</ListItem>

A metódus meghívásához a következő XML-elemet használhatja ToString :The following XML element can be used to calling the ToString method:

  • A listaelem elem a nézet által megjelenített adatértékeket határozza meg.The ListItem element specifies the data that is displayed by the view.

  • A scriptblock kulcsszót elem (nem látható) Megadja azt a parancsfájlt, amelynek az értékét a nézet jeleníti meg.The ScriptBlock element (not shown) specifies the script whose value is displayed by the view. Meg kell adnia egy parancsfájlt vagy egy tulajdonságot, de mindkettőt nem adhatja meg.You must specify either a script or a property, but you cannot specify both.

Lásd még:See Also

Windows PowerShell-parancsmag írásaWriting a Windows PowerShell Cmdlet